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PREFACE 
to the Third Edition 



In the months since the last appearance of this manual, many 
changes have occurred both in the system itself and in the way it 
is used. 

Perhaps most obviously, there have been additions, deletions, and 
mDdif ications to the system and its software. It is these 
changes, of course, that caused the appearance of this revised 
manual. 

Second, the number of people spending an appreciable amount of 
time writing UNIX software has increased. Credit is due to 
L. L. Cherry, M. D. Mcllroy, L« E, McMahon, R. Morris, 
J, F. Ossanna, and E. N. Pinson for their contributions. 

Finally, the number of UNIX installations has grown to 16, with 
more expected. None of these has exactly the same Complement of 
hardware or software. Therefore, at any particular installation, 
it is quite possible that this manual will give inappropriate 
information. 

In particular, any system which uses a PDP ~1 1/20 processor will 
not include all the software described herein , nor will the 
software behave the same way . The second, or even the first, 
edition of this manual is likely to be more appropriate. 

Besides additions, deletions, and modifications to the writeups 
in each section, this manual differs from its predecessors in two 
ways: all the commands used for system maintenance and not in- 
tended for normal users have been moved to a new section VIII; 
and there is a new "how to Get Started" chapter that gives some 
elementary facts and many pointers to other sections. 



- ii - 



INTRODUCTION TO THIS MANUAL 



This manual gives descriptions of the publicly available features 
of UNIX. It provides neither a general overview (see "The UNIX 
Time-sharing System** for that) nor details of the implementation 
of the system (which remain to be disclosed). 

Within the area it surveys, this manual attempts to be as com- 
plete and timely as possible. A conscious decision was made to 
describe each program in exactly the state it was in at the time 
its manual section was prepared. In particular, the desire to 
describe something as it should be, not as it is, was resisted. 
Inevitably, this means that many sections will soon be out of 
date. (The rate of change of the system is so great that a 
dismayingly large number of early sections had to be modified 
while the rest were being written. The unbounded effort required 
to stay up-to-date is best indicated by the fact that several of 
the programs described were written specifically to aid in 
preparation of this manual!) 

This manual is divided into eight sections: 



I. 


Commands 


II. 


System calls 


III. 


Subroutines 


IV. 


Special files 


V. 


File formats 


VI. 


User-maintained programs 


VII. 


Miscellaneous 


VIII. 


Maintenance 



Commands are programs intended to be invoked directly by the 
user, in contradistinction to subroutines, which are intended to 
be called by the user's programs. Commands generally reside in 
directory /bin (for binary programs). This directory is searched 
automatically by the command line interpreter. Some programs 
classified as commands are located elsewhere; this fact is indi- 
cated in the appropriate sections. 

System calls are entries into the UNIX supervisor. Jn assembly 
language, they are coded with the use of the opcode sys , a 
synonym for the trap instruction. 

A small assortment of subroutines is available; they are 
described in section III. The binary form of most of them is 
kept in the system library /lib/liba.a. 

The special files section IV discusses the characteristics of 
each system ''file" which actually refers to an l/O device. 
Unlike previous editions, the names in this section refer to the 
DEC device names for the hardware, :|.nstead of the names of the 
special files themselves. 
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The file formats section V documents the structure of particular 
kinds of files; for example, the form of the output of the loader 
and assembler is given. Excluded are files used by only one com- 
mand, for example the assembler's intermediate files. 

User-maintained programs (section VI ) are not considered part of 
the UNIX system, and the principal reason for listing them is to 
indicate their existence without necessarily giving a complete 
description. The author should be consulted for information. 

The miscellaneous section (VIl) gathers odds and ends. 

Section VIII discusses commands which are not intended for use by 
the ordinary user, in some cases because they disclose informa- 
tion in which he is presumably not interested, and in others 
because they perform privileged functions. 



Each section consists of a number of independent entries of a 
page or so each. The name of the entry is in the upper corners 
of its pages, its preparation date in the upper middle. Entries 
within each section are alphabetized. ThiB page numbers of each 
entry start at 1 . (The earlier hope for frequent, partial up- 
dates of the manual is clearly in vain, but in any event it is 
not feasible to maintain consecutive page numbering in a document 
like this.) 

All entries have a common format. 

The name section repeats the entry name and gives a very 
short description of its purpose. 

synopsis summarizes the use of the program being 
described. A few conventions are used, particularly in the 
Commands section: 

Underlined words are considered literals, and are typed 
just as they appear. 

Square brackets ( [] ) around an argument indicate that the 
argument is optional. When an argument is given as 
"name", it always refers to a file name. 

Ellipses are used to show that the previous 

argument-prototype may be repeated. 

A final convention is used by the commands^themselves. 
An argument beginning with a minus sign is often teUc- 

en to mean some sort of flag argument even if it appears 
in a position where a file name could appear. Therefore, 
it is unwise to have files whose names begin with - . 

The description section discusses in detail the subject at 
hand. 

The files section gives the names of files which are built 
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into the program. 

A see also section gives pointers to related information. 

A diagnostics section discusses the diagnostics that may be 
produced. This section tends to be as terse as the diagnos- 
tics themselves. 

The bugs section gives known bugs and sometimes deficien- 
cies. Occasionally also the suggested fix is described. 

Previous edition of this manual had an owner section, which has 
been dropped from this edition because the "owners" of many 
routines became fairly hard to pin down. The major contributors 
to UNIX, (cast in order of appearance) together with their login 
names and most notable contributions, are 



Ken 


K. 


Thompson 


(UNIX, many commands ) 


dmr 


D. 


M. Ritchie 


(many commands, as, Id, c) 


jfo 


J. 


F. Ossanna 


(roff, nroff) 


doug 


M. 


D. Mcllroy 


(tmg, m6) 


rhm 


R. 


Morris 


(dc, much of library) 


lem 


L. 


E. McMahon 


(cref) 


11c 


L. 


L. Cherry 


(form, fed, salloc) 


csr 


c. 


S. Roberts 


(tss) 


enp 


E. 


N. Pinson 


(proof) 



At the beginning of this document is a table of contents, organ- 
ized by section and alphabetically within each section. There is 
also a permuted index derived from the table of contents. Within 
each index entry, the title of the writeup to which it refers is 
followed by the appropriate section number in parentheses. This 
fact is important because there is considerable name duplication 
among the sections, arising principally from commands which exist 
only to exercise a particular system call. 



This manual was prepared using the UNIX text editor ed and the 
formatting program roff . 

The assistance of R. Morris is gratefully acknowledged. 
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HOW TO GET STARTED 



This section provides the basic information you need to get 
started on UNIX: how to log in and log out, how to communicate 
through your terminal, and how to run a program. 

Locrqing in 

You must call UNIX from an appropriate terminal. UNIX supports 
ASCII terminals typified by the TTY 37, the GE Terminet 300, the 
Memorex 1240, and various graphical terminals on the one hand, 
and IBM 2741 -type terminals on the other. 

To use UNIX, you must have a valid UNIX user name, which may be 
obtained, together with the telephone number, from the system 
administrators. 

The same telephone number serves terminals operating at all the 
standard speeds. After a data connection is established, the 
login procedure depends on what kind of terminal you are using. 

TTY 37 terminal 

UNIX will type out "login; you respond with your user 
name. From the TTY 37 terminal, and any other which has the 
"new-line" function (combined carriage^ re turn and linefeed) , 
terminate each line you type with the "new line" key ( not 
the "return" key). 

3 00 -baud terminals 

Such terminals include the GE Terminet 300, most display 
terminals, Execuport, TI , and certain Anderson-Jacobson ter- 
minals. These terminals generally have a speed switch which 
should be set at "300" (or "30" for 30 characters per 
second) and a half /full duplex switch which should be set at 
full-duplex. (Note that this switch will often have to be 
changed since MH-TSS requires half-duplex) . When a connec- 
tion with UNIX is established, a few garbage characters are 
typed j^the login message at the wrong speed). Depress the 
"break key; this is a speed-independent signal^to UNIX^that 
a 300-baud terminal is in use. UNIX will type "login; " at 
the correct speed; you type your user name, followed by the 
"return" key. Henceforth, the "return", "new line", or 

linefeed" keys will give exactly the same results. Each 
line must be terminated with one of these keys; no one is 
listening to you until the return is received. 

Selectric terminals 

From an IBM 2741 or the Anderson-Jacobson Selectric termi- 
nal, no message will appear. After the data connection is 
established, press the return" key. UNIX should type 
"login; " as described above. If the greeting does not 
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appear after a few seconds, unlock the keyboard by switching 
the terminal to local and back to remote, and type "return". 
If necessary, hang up and try again; something has gone 
wrong. 

For all these terminals, it is important that you type your name 
in lower case if possible; if you type upper case letters, UNIX 
will assume that your terminal cannot generate lower— case letters 
and will translate all subsequent upper-case letters to lower 
case. 

The evidence that you have successfully logged in is that a UNIX 
program, the Shell, will type a to you.^ (The Shell is 

described below under "how to run a program". 

For more information, consult getty(VIl). which discusses the 
login sequence in more detail, and dc(lV), which discusses type- 
writer I/O. 

Logging out 

There are three ways to log out: 

You can simply hang up the phone. Hanging up is safe if you 
are at command level^^ that is, if the shell has just typed 
its prompt signal "% . it is also safe if you are in in- 
teractive system programs, for example the editor. It is 
unsafe if you are executing a non-interactive program, or 
one of your own programs, which either does not read the 
typewriter or ignores the end-of-file indications which will 
result from hanging up. The reason is that UNIX, unlike 
most systems, does not terminate a program simply because it 
has been hung-up upon. 

You can log out by typing an end-of-file indication (EOT 
character, control "d ) to the Shell. The Shell will ter- 
minate and the "login: " message will appear again. 

You can also log in directly as another user by giving a 
login command (login (l)). 

How to communicate through your terminal 

When you type to UNIX, a gnome deep in the system is gathering 
yDur characters and saving them in a secret place. The charac- 
ters will not be given to a program until you type a return, as 
described above in Logging in. 

UNIX typewriter I/O is full-duplex (except for Selectric termi- 
nals). It has full read-ahead, which means that you can type at 
any time, even while a program is typing at you. Of course, if 
you type during output , the output will have the input characters 
interspersed. However, whatever you type will be saved up and 
interpreted in correct sequence. 

There is a limit to the amount of read-ahead, but it is generous 
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and not likely to be exceeded unless the system is in trouble. 
When the read-ahead limit is exceeded^^ the system stops echoing 
input characters, and starts echoing #" no matter what you 
typed. The last character which was echoed correctly will be 
received correctly by the program to which you were talking; sub- 
sequent characters have been thrown away. 

On a typewriter input line, the character kills all the char- 
acters typed before it, so typing mistakes can be repaired on a 
single line. Also, the character erases the last character 
typed. Successive uses of erase characters back to, but not 
beyond, the beginning of the line. @ and # can be transmit- 
ted to a program by preceding them with "X". (So, to erase "X", 
you need two #''s). 

The ASCII "delete" (a.k.a. "rubout") character is not passed to 
programs but instead generates an interrupt signal . This signal 
generally causes whatever program you are running to terminate. 
It is typically used to stop a long printout that you don't want. 
However, programs can arrange either to ignore this signal alto- 
gether, or to be notified when it happens (instead of being ter- 
minated). The editor, for example, catches interrupts and stops 
what it is doing, instead of terminating, so that an interrupt 
can be used to halt an editor printout without losing the file 
being edited. 

The quit signal is generated by typing the ASCII FS character. 
It not only causes a running program to terminate but also gen- 
erates a file with the core image of the terminated process. 
Quit is useful for debugging. 

Besides adapting to the speed of the terminal, UNIX tries to be 
intelligent about whether you have a terminal with the "new line" 
function or whether it must be simulated with carriage-return and 
line-feed. In the latter case, all input carriage returns are 
turned to new-line characters (the standard line delimiter) and 
both a carriage return and a line feed are echoed to the termi- 
nal. If you get into the wrong mode, the stty command (l) will 
rescue you. 

Tab characters are used freely in UNIX source programs. If your 
terminal does , not have the tab function, you can arrange to have 
them turned into spaces during output, and echoed as spaces dur- 
ing input. The system assumes that tabs are set every eight 
columns. Again, the stty command (l) will set or reset this 
mode. Also^ there is a file which, if printed on TTY 37 or Ter- 
miNet 300 teminals, will set the tab stops correctly 
(tabs(VIl)). 

Section dc(iv) discusses typewriter l/O more fully. Section 
kl(iv) discusses the console typewriter. 

How to run a program : The Shell 

When you have successfully logged into UNIX, a program called the 
Shell is listening to your terminal. The Shell reads typed-in 
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lines, splits them up into a command name and arguments, and exe- 
cutes the command. A command is simply an executable program. 
The Shell looks first in your current directory (see next sec- 
tion) for a program with the given name, and if none is there, 
then in a system directory. There is nothing special about 
system-provided commands except that they are kept in a directory 
vAiere the Shell can find them. 

The command name is always the first word on an input line; it 
and its arguments are separated from one another by spaces. 

When a program terminates, the Shell will ordinarily regain con- 
trol and type a at you to indicate that it is ready for 
another command. 

The Shell has many other capabilities, which are described in 
detail in section sh(l). 

The current directory 

UNIX has a file system arranged in a hierarchy of directories. 
When the system administrator gave you a user name, he also 
created a directory for you (ordinarily with the same name as 
yDur user name). When you log in, any file name you type is by 
default in this directory. Since you are the owner of this 
directory, you have full permissions to read, write, alter, or 
destroy its contents. Permissions to have your will with other 
directories and files will have been granted or denied to you by 
their owners. As a matter of observed fact, few UNIX users pro- 
tect their files from destruction, let alone perusal, by other 
users. 

To change the current directory (but not the set of permissions 
you were endowed with at login) use chdir(l). 

Path names 

To reference files not in the current directory, you must use a 
path name. 

Full path names begin with "/", the name of the root directory of 
the whole file system. After the slash comes the name of each 
directory containing the next sub-directory (followed by a "/"^ 
until finally the file name is reached. ^E.o[.: ][/usr/Lem/f ilex 
refers to file "filex** in directory ""lem"; lem" is itself a 
sub-directory of "usr"; "usr" springs directly from the root 
directory. 

If your current directory has subdirectories, the path names of 
files therein begin with the name of the subdirectory (no pre- 
fixed -/"). 

Without important exception, a path name may be used anywhere a 
file name is required. 

Important commands which modify the contents of files are cp(l), 



mv(l), and rm(l), which respectively copy, move (i.e. rename) and 
remove files. To find out the status of files or directories, 
use ls(l) and stat(l). See mkdir(i) for making directories; 
rmdir(l) for destroying them. 

For a fuller discussion of the file system, see MM-71 -1 273-4. It 
may also be useful to glance through section II of this manual, 
which discusses system calls, even if you don't intend to deal 
with the system at the assembly-language level. 

Writing a program 

To enter the text of a source program into a UNIX file, use 
ed(l). The three principal languages in UNIX are assembly 
language (see as(l)), Fortran (see fc(l)), and C (see cc(l)). 
After the program text has been entered through the editor and 
written on a file, you can give the file to the appropriate 
language processor as an argument. The output of the language 
processor will be left on a file in the current directory named 
a. out". (if the output is precious, use mv to move it to a less 
exposed name soon.) If you wrote in assembly language, you will 
probably need to load the program with library subroutines; see 
ld(l). The other two language processors call the loader au- 
tomatically. 

When you have finally gone through this entire process without 
provoking any diagnostics, the resulting program can be run by 
giving its name to the Shell in response to the prompt. 

The next command you will need is db(l). As a debugger, db is 
better than average for assembly-language programs, marginally 
useful for C programs (when completed, cdb(l) will be a boon), 
and virtually useless for Fortran. 

Your programs can receive arguments from the command line just as 
system programs do. For assembly language programs, see 
exec (II) . 

Text processing 

Almost all text is entered through the editor. The commands most 
often used to write text on a terminal are; cat(l), pr(l), 
roff(l), or nroff(l). 

The cat command simply dumps ASCII text on the terminal, with no 
processing at all. The pr command paginates the text and sup- 
plies headings. The nroff command is an elaborate text format- 
ting program, and requires careful forethought in entering both 
the text and the formatting commands into the input file. The 
roff command is a somewhat less elaborate formatting program, and 
requires somewhat less forethought. 

Surprises 

Certain commands provide inter-user communication. Even if you 
do not plan to use them, it would be well to learn something 
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about them, because someone else may aim them at you. 

To communicate with another user currently logged in, write (l) is 
used. To leave a message the presence of which will be announced 
to another user when he next logs in, mail(l) is used. The 
write-ups in the manual also suggest how to respond to the two 
commands if you are a target. 

When you log in, a message-of~the-day may greet you before the 
first 
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I • COMMANDS 



: • place label 

ar •••• ••••••••• archive (combine) files 

as ••••• • • • assembler 

bas ••••• • BASIC dialect 

cat ••••••••• concatenate (or print) files 

cc ••••• • compile C program 

cdb •••••• ••••••••• C debugger 

chdir ••••••••••••••••••••••• change working directory 

chmod ••••• change access mode of files 

chown •••••••••••••••• • change owner of files 

cmp ••••• ••••••••••• compare file contents 

cp • ••••••••••• copy file 

cref • cross reference table 

crypt •••••••• •••• encrypt, decrypt a file 

date ••••• get date and time of day 

db •••• • •••••• symbolic debugger 

dc ••••••••••••••••• desk calculator 

df •••••••••• • •••• find free disk space 

dsw ••••••••••••••••••••••••• delete files interactively 

du •••••••••• find disk usage 

echo ••••••••••• ••••• print command arguments 

ed ••••••••••••••• • text editor 

exit • • ••••• • end command sequence 

factor ••••••••••••••••••••• • factor a number 

fc ••«•••• •••• compile Fortran program 

fed •••••• • form letter editor 

form •••• generate form letter 

forml ••••• ••••• generate form letters 

goto •••••• ••••••••••• command transfer 

hyphen • •••• find hyphenated words 

if ••••••• ••••••• conditional command 

Id •••••••••••••••••• link editor ( loader) 

In ••••• link to file 

login ••••••••• log on to system 

Is •••••••••••••••••••••••••• list contents of directory 

m6 •••••••••• ••••••••• macroprocessor 

mail ••••••• ••••••••••• send mail to another user 

man •••••• ••••••••••••••runoff manual section 

mesg •••••••••••••• •••• permit or deny messages 

mkdir ••••••••••••••• ••• create directory 

mt • • •• save , restore files on magtape 

mv •••• • move or rename file 

nm •••••••••••••••••••••••••• print namelist 

nroff ••••••••••••••••••••••• format text for printing 

od ••••••••••••••••• ••• octal dump of file 

opr • ••••••••••••• print file off-line 

ov •••••••••••••••••••••••••• page overlay file print 

passwd •••••••••••••••••••••• set login password 

pr •••••• ••••••• print file with headings 

proof ••••••••••••••••••••••• compare text f ile s 

reloc ••••••••••••••• • relocate object files 
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rew ••••• rewind DECtape 

rm •••••• ••••••••• remove (delete) file 

rmdlr •••••••••••• remove (delete) directory 

roff • format text for printing 

sh • • ••••••• command interpreter 

size ••••••• get executable program size 

sno •••••••••••••• compile Snobol program 

sort sort ASCII file 

speak ••••••••••••••••••••••• send words to voice synthesizer 

split ••••••••••• • break a file into pieces 

Stat ••••• get file status 

strip • *••••••••••• remove symbols , relocation bits 

stty ••••••••••••••••••• set typewriter modes 

sum • sum file 

tap ••••••••••• ••••••••• save, restore files on DECtape 

time ••••• •••••••• get time information 

tmg ••••••••••••••••••••••••• compile tmgl program 

tss ••••••••• communicate with MH-TSS (GCOS ) 

tty ••••• •••••• • find name of terminal 

type • ••••• print f ile page-by-page 

typo ••••••••••••• find typographic errors 

\xi •••••• •••••••••••••• find undefined symbols 

miq • ••••• ••••••• find duplicate lines in a file 

vs ••••• ••••••• generate voice synthesizer phonemes 

wc • •••••••• get (English) word count 

who ••••••••••••••••••••••••• who is on the system 

write ••••••••••••••••••••••• write to another user 

II. SYSTEM CALLS 

boot •••••••••••••••••••••••• reboot the system 

break •••••••••••••••••• set program break 

cemt ••••••••• catch EMT traps 

chdir •••••••••••••••• change working directory 

chmod ••••••••••••••••• change mode of file 

chown ••••••••••• change owner of f ile 

close ••••••••••••••••••••••• close open file 

creat ••••••••••••••• create file 

csw ••••••••• ••••••••• read the console switches 

dup ••••••••• duplicate an open file 

exec ••••••• •••••••••••• execute program file 

exit ••••• •••••••••••••• terminate execution 

fork •••••••••••••••••••••••• create new process 

f pe •••••••••••••••••• catch floating exception errors 

fstat •••• ••••••••••••• status of open file 

getuid • • get user ID 

gtty ••••• ••••••••• get typewriter mode 

ilgins catch illegal instruction trap 

intr •••••• catch or inhibit interrupts 

kill •••••••••••••••••••••••• destroy process 

link link to file 

makdir create directory 

mdate set date modified of file 

mount mount file system 

nice set low-priority status 
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open •••••• •••••••• open file 

pipe •••••• • open inter process channel 

quit • Inhibit quits 

read ••••••••••••• read file 

rele •••••••••• release processor 

seek • •••• move read or write pointer 

setuid ••••••••••••••• set user ID 

sleep • ••••• delay execution 

Stat ••• •••• get file status 

stime •••••••••••• set system time 

stty ••••••••••«•• set mode of typewriter 

sync assure synchronization 

time ••••••• get time of year 

times ••••••••••••••••••••••• get execution times 

unount •••••••• •••••••• dismount file system 

unlink remove (delete) file 

wait wait for process 

write write file 



III. SUBROUTINES 



atan ••••••••• • arctangent 

atof ••••••••••• convert ASCII to floating 

atoi ••••••••••••••• convert ASCII to integer 

oompar •••••••••••••••• string compare for sort 

crypt •••••• ••••••••••• encrypt according to a keyword 

ctime •••• •••••••••••• convert time to ASCII 

ddsput •••••••••••••••••••••• display character on Picturephone 

ecvt •••••••••••••••••• • edited output conversion 

exp ••••••••• ••••••••• exponential function 

f toa •••••••• convert floating to ASCII 

f too ••••••••••••• ••••• convert floating to octal 

gerts ••••• ••••• • communicate with GCOS 

getc •••••••••••• ••••••• get character 

hypot •••••••••••••••••• compute hypotenuse 

itoa ••••• •••••• convert integer to ASCII 

log •••• • ••••• logarithm base e 

mesg •••••••••••••••• print string on typewriter 

nlist ••••••••••••••••••••••• read name list 

pow •••••••• •••• take powers of numbers 

ptime •••••• • • print time 

putc ••••• •••••• write character or word 

qsort • •••••••••• • quicker sort 

rand •••••••• • pseudo random number generator 

salloc ••••••••••••• •••• storage allocator 

sin ••••••••••••••••• • sine , cosine 

sqrt •••••• ••••• • square root 

switch •••••••••••••••••••••• transfer depending on value 

ttyn ••••••••••• find teletype name 



IV. SPECIAL FILES 

dc •••••••••••••••••••••••••• remote typewriter 

dn • • • • • • • • • 801 ACU 
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dp • ••••• 201 Dataphone 

)0. •••• console typewriter 

mem ••••••••••••••••••••••••• core memory 

pc •••• • punched paper tape 

rf RF disk 

rk RK disk 

tc •••••••••••••••• DECtape 

tm*,«*.«««.,« •••••••••• 9--track magtape 

vt • •••••••• storage~tube display 



V. FILE FORMATS 



a.out •••••••••••• • assembler and loader output 

archive •••••• archive file 

core ••••••• core Image file 

directory •••• • • directory format 

file system ••••••••••••••••• file system format 

passwd •••••• password file 

tap •••••••• ••••• DECtape and magtape format 

utmp •••••• logged-ln user Information 

wtmp •••••••••••• •••• accounting files 



VI. USER MAINTAINED PROGRAMS 

be 

bj 

ptx ••••••••••• ••••••• 

yacc ••••••••••• •••••• 



compile B program 
blackjack 
permuted Index 

yet another compiler-compiler 



VII. MISCELLANEOUS 

ascll ••• map of ASCII 

dpd. spawn dataphone daemon 

getty adapt to typewriter 

glob •••• argument expander 

greek •••• extended TTY 37 typebox map 

Inlt • Initializer process 

msh ••. mini Shell 

tabs set tab stops on typewriter 

vsp voice synthesizer phonemes 



VIII. SYSTEM MAINTAINANCE 

20boot reboot 1 1 /20 system 

acct get connect-tlme accounting 

bproc boot procedure 

check check cons Istency of file system 

chk • check all file systems 

clrl clear file's 1-node 

dcheck verify directory hierarchy 

dll load DEC binary paper tapes 

Istat file status by 1-number 
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kill •••••••••••••••••••••••• terminate a process 

mount ••••••••••••••••••••••• mount removable file system 

ps • ••••• get process status 

salv ••••••••••••• repair damaged file system 

su«*«»,«««««««««,«»««**»,««« become super-user 

s»7tmp ••••• truncate accounting files 

tm •••••••••••••• get system time Information 

umount •••••••••••• dismount removable file system 
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INDEX 



20boot(vill) : reboot 
dp(lV) : 

greek(VIl)! extended TTY 

dn(iv): 
tm(iv) : 



chmodd): change 
crypt(lll): encrypt 
wtmp(v) : 

acct(VIIl): get connect-time 

dn(lV) ! 801 
getty(VIl) : 
chk(VIIl)! check 
salloc(lll)! storage 
dup(ll) ; duplicate 
yacc(VI ) : yet 
mall(l): send mail to 
write(l): write to 
ar(l): 
archive (v) ; 

atan(lll) : 
glob(VIl): 
echo(l): print command 

sort ( I ) : sort 
atof(lll)! convert 
atoi(lll); convert 

ascii(vil): map of 
Gtime(lll): convert time to 
convert floating to 
itoa(lll): convert integer to 

a.out(v) : 
as(l): 
sync(ll) : 



be (VI ) : compile 
log(lll): logarithm 

bas(l): 

dli(vill) : load DEC 
remove symbols, relocation 

bj(Vl): 



11/20 system 
201 Dataphone 

20boot(VIIl) ! reboot 11/20 system 
37 typebox map 
801 ACU 

9-track magtape 
; ( I ) ; place label 

a.out(v): assembler and loader output 

access mode of files 

according to a keyword 

accounting files 

accounting 

acct(VIIl): get connect-time accounting 
ACU 

adapt to typewriter 
all file systems 
allocator 
an open file 

another compiler-compiler 

another user 

another user 

archive (combine) files 

archive file 

archive(V): archive file 
arctangent 
argument expander 
arguments 

ar( I ): archive (combine) files 

ASCII file 

ASCII to floating 

ASCII to integer 

ascii(VIl): map of ASCII 

ASCII 

ASCII 

ASCII ...ftoa (III) ! 
ASCII 

as(l); assembler 

assembler and loader output 

assembler 

assure synchronization 

a tan (ill): arctangent 

atpfdll): convert ASCII to floating 

atoi(lll): convert ASCII to integer 

B program 

base e 

bas(l): BASIC dialect 

BASIC dialect 

bc(Vl): compile B program 

binary paper tapes 

bits .strip(l) : 

bj(vi ) : blackjack 

blackjack 
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bproc(VIIl) : 



split(l): 

break(ll): set program 
istat(vill): file status 

cdb(l) : 
cc(l ) : compile 
dc(l ) : desk 
cemt(ll) 
fpe(ll) 
ilgins(ll) 
intr(ll) 



chmod ( I ) 
chmod(ll) 
chown( I ) 
chown(ll) 
chdir(l) 
chdir(ll) 
pipedl): open inter process 
ddsput(lll)t display 
putc(ill) : write 
getc(lll) : get 



chk(vill) : 
check (VI II) : 
system • • • 



clri(vill) i 
close(ll) : 



ar(l) : archive 
echo(l); print 
sh(l): 
exitd ) : end 
goto ( I ) : 
if(l): conditional 
gerts(lll): 
tss(l): 
crap(l): 
compar( III ) : string 
proof ( I ) ! 

bc(vi): 



boot procedure 

boot(ll): reboot the system 

bproc(VIIl): boot procedure 

break a file into pieces 

breakdl): set program break 

break 

by i -number 
C debugger 
C program 
calculator 
catch EMT traps 

catch floating exception errors 

catch illegal instruction trap 

catch or inhibit interrupts 

cat(l): concatenate (or print) files 

cc(l): compile C program 

cdb(l): C debugger 

cemtdl): catch EMT traps 

change access mode of files 

change mode of file 

change owner of files 

change owner of file 

change working directory 

change working directory 

channel 

on Picturephone 
or word 



character 
character 
character 
chdir(l): 
chdir(ll) 
check all 



change working directory 

change working directory 
file systems 
check consistency of file system 
check(VIIl): check consistency of file 
chk(vill)j check all file systems 
chmod(l): change access mode of files 
chmod ( II )t change mode of file 
chown(l): change owner of files 
chown(ll): change owner of file 
clear file's i-node 
close open file 
close(ll): close open file 
clri(VIIl): clear file's i-node 
cmpd): compare file contents 
(combine) files 
command arguments 
command interpreter 
command sequence 
command transfer 
command 

communicate with GCOS 
communicate with MH-TSS (GCOS) 
compare file contents 
compare for sort 
compare text files 

comipar(lll): string compare for sort 
compile B program 
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CC(I) ! 

fed): 
sno(l) ; 
tmg(l)s 

yacc(Vl); yet another 
hypot(lll) ! 
cat(l) ! 

if(l): 
acct(vill) : get 
check(VIIl): check 
csw(ll): read the 
kldv): 
ls(l): list 
cmp(l): compare file 
ecvt(lll): edited output 
atof (III) : 
atoi(lll) : 
ftoa(ill)! 
ftoodll) : 
itoa(lll); 
ctime(lll) : 
cpd): 
core(v) ; 
mem(iv) : 

sindll): sine, 
wed): get (English) word 

makdir(ll): 
mkdir(l): 
creat(ll) : 
forkdl): 



cref (l) : 



dpd(vil): spawn data phone 
salv(vill): repair 
dpd(VIl): spawn 
dp(lV) : 201 
date(l) : get 
mdatedl ) : set 

dated): get date and time of 



Picturephone ... 

cdb(l) : C 
db(l ) : symbolic 
dli(vill): load 
crypt(l): encrypt. 



compile C program 
compile Fortran program 
compile Snobol program 
compile tmgl program 
compiler-compiler 
compute hypotenuse 
concatenate (or print) files 
conditional command 
connect~time accounting 
consistency of file system 
console switches 
console typewriter 
contents of directory 
contents 
conversion 

convert ASCII to floating 
convert ASCII to integer 
convert floating to ASCII 
convert floating to octal 
convert integer to ASCII 
convert time to ASCII 
copy file 
core image file 
core memory 

core(v): core image file 

cosine 

count 

cpd ) : copy file 

create directory 

create directory 

create file 

create new process 

creat(ll): create file 

cref(l): cross reference table 

cross reference table 

crypt(l): encrypt, decrypt a file 

crypt(lll); encrypt according to a keywor( 

csw(ll); read the console switches 

ctime(lll): convert time to ASCII 

daemon 

damaged file system 
dataphone daemon 
Dataphone 

date and time of day 

date modified of file 

date(l): get date and time of day 

day 

db(l): symbolic debugger 

dcheck(vill ) : verify directory hierarchy 

dc(l): desk calculator 

dcdv): remote typewriter 

ddsput(lll): display character on 

debugger 

debugger 

DEC binary paper tapes 
decrypt a file 
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tap(V): 
rew(l): rewind 
save, restore files on 

tc(lV): 
sleep(ll): 
dsw(l): 
rmdir(l)! remove 
rin(l): remove 
unlink(ll): remove 
mesg(l): permit or 
switch(lll): transfer 

dc(l): 
kill (II): 

bas(l): BASIC 
directory( V) : 
dcheck(VIIl) : verify 

chdir(l): change working 
chdir(ll): change working 
ls(l): list contents of 
makdir(ll): create 
mkdir(l): create 
rmdir(l): remove (delete) 
df(l): find free 
dud): find 
rf(IV): RF 
rk(iv): RK 
umount(ll): 
ddsput(lll): 
vt(iv): storage-tube 



od(l); octal 

dup(ll): 
uniq(l): find 



ecvt(lll): 
ld(l): link 
ed(l): text 
fed(l): form letter 
cemt(ll)j catch 
crypt (ill): 
crypt(l) : 
exit(l): 
wc ( I ) : get 
catch floating exception 
typo ( I ) : f ind ty pogr aph i c 
fpe(ll); catch floating 



DEC tape and magtape format 
DECtape 

DECtape. . .tap( I ) : 
DECtape 

delay execution 

delete files interactively 

(delete) directory 

(delete) file 

(delete) file 

deny messages 

depending on value 

desk calculator 

destroy process 

df(l): find free disk space 

dialect 

directory format 

directory hierarchy 

directory( V) : directory format 

directory 

directory 

directory 

directory 

directory 

directory 

disk space 

disk usage 

disk 

disk 

dismount file system 

display character on Picturephone 

display 

dli(VIIl): load DEC binary paper tapes 
dn(lV): 801 ACU 

dpd(VIl): spawn dataphone daemon 

dp (IV): 201 Dataphone 

dsw(l): delete files interactively 

du(l): find disk usage 

dump of file 

dup(Il): duplicate an open file 

duplicate an open file 

duplicate lines in a file 

echo(l): print command arguments 

ecvt(lll): edited output conversion 

ed(l): text editor 

edited output conversion 

editor (loader) 

editor 

editor 

EMT traps 

encrypt according to a keyword 

encrypt, decrypt a file 

end command sequence 

(English) word count 

errors. . •fpe( II) : 

errors 

exception errors 
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size(l): get 
exec ( II) : 
times ( II ) : get 
exit (II): terminate 
sleep (II): del ay- 



glob (VII): argument 

exp( III ) : 
greek (VII): 
log(lll): logarithm base 
factor ( I ) : 



cmp( I ) : compare 
split(l): break a 
opr ( I ) : print 
type(l): print 
ov(l): page overlay 
istat( VIII) ; 
stat(l): get 
stat(Il): get 
file system(V): 
chk(VIIl): check all 

check consistency of 
mount ( I I ) : mount 
mount(VIIl): mount removable 
salv(VIIl): repair damaged 
umoun t (II): di smount 
pr(l): print 
clri(VIIl): clear 
dsw(l): delete 
tap(l); save, restore 
mt(l): save, restore 
ar(l): archive (combine) 
concatenate (or print) 
change access mode of 
chown(l): change owner of 
proof (l): compare text 
reloc(l): relocate object 
wtmp(V); accounting 
archive(V): archive 
chraod ( I I ) : change mode of 
chown(ll): change owner of 
close (II): close open 
core(v): core image 
cp(l): copy 
creat(ll): create 
crypt (I ): encrypt, decrypt a 
dup(ll): duplicate an open 
exec(ll): execute program 
fstat(ll): status of open 



exec(ll): execute program file 

executable program size 

execute program file 

execution times 

execution 

execution 

exit (I): end command sequence 
exit(ll): terminate execution 
expander 

exp(lll): exponential function 
exponential function 
extended TTY 37 typebox map 
e 

factor a number 
factor(l): factor a number 
fc(l): compile Fortran program 
fed(l): form letter editor 
file contents 
file into pieces 
file off-line 
file page-by-page 
file print 

file status by i-number 

file status 

file status 

file system format 

file systems 

file system(V): file system format 

file system. , .check (VIII ) : 

file system 

file system 

file system 

file system 

file with headings 

file's i-node 

files interactively 

files on DECtape 

files on magtape 

files 

f iles. . . cat (I ) : 

f iles. . .chmodd ) : 

files 

files 

files 

files 

file 

file 

file 

file 

file 

file 

file 

file 

file 

file 

file 
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link(Il) : link to 
ln(l) J link to 
set date modified of 
mv(l): move or rename 
od(l): octal dump of 
open (II): open 
passwd(V): password 
read(ll): read 
rm(l): remove (delete) 
sort(l): sort ASCII 
sum ( I ) : sum 
find duplicate lines in a 
unlink(ll): remove (delete) 
write(ll): write 
du(l): 
uniq(l): 
df(l): 
hyphen ( I ) : 
tty(l): 
ttyn(lll) : 
typo(l): 
un(l): 
fpe(ll); catch 
f toa ( III ) : convert 
ftoo(lll): convert 
atof(lll): convert ASCII to 

fed(l): 
forml(l): generate 
form(l): generate 
nroff (I): 
roff (I): 

directory( V) : directory 
file system(V): file system 
tap(V): DECtape and magtape 



fc(l): compile 
df(l): find 



exp(lll): exponential 
communicate with MH-TSS 
gerts(lll): communicate with 

forml(l): 
form(l)! 
vs(l): 

pseudo random number 

getc(lll): 
acct(VIIl): 
date(l) : 
wc(l): 
size(l): 



file 
file 

f ile. . .mdate( II ) : 

file 

file 

file 

file 

file 

file 

file 

file 

file. • .uniq(l ) : 

file 

file 

find disk usage 

find duplicate lines in a file 

find free disk space 

find hyphenated words 

find name of terminal 

find teletype name 

find typographic errors 

find undefined symbols 

floating exception errors 

floating to ASCII 

floating to octal 

floating 

fork(ll): create new process 
form letter editor 
form letters 
form letter 

format text for printing 

format text for printing 

format 

format 

format 

form(l); generate form letter 
forral(l): generate form letters 
Fortran program 

fpe(ll): catch floating exception errors 
free disk space 

fstat(ll): status of open file 

ftoa(lll): convert floating to ASCII 

ftoo(lll): convert floating to octal 

function 

(GCOS)...tss(l): 

GCOS 

generate form letters 

generate form letter 

generate voice synthesizer phonemes 

generator. • .rand (III) : 

gerts(lll): communicate with GCOS 

get character 

get connect -time accounting 
get date and time of day 
get (English) word count 
get executable program size 
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times(ll) 
Stat (I) 
stat(ll) 
ps(VIIl) 
time(l) 
time(II) 
gtty(ll) 
getuid( II ) 



pr(l): print file with 
verify directory 
hyphen(l ) : find 

hypot(lll): compute 

clri(VIIl): clear file's 
istat(VIIl): file status by 
getuid(ll): get user 
setuid(ll): set user 



ilgins(ll): catch 
core(V): core 
uniq(l): find duplicate lines 
ptx(Vl); permuted 
time(l): get time 
utmp(V): logged~in user 
intr(ll); catch or 
quit (II): 
init(VIl): 

ilgins(ll): catch illegal 
itoa(lll): convert 
atoi(lll): convert ASCII to 
pipe(ll): open 
dsw(l): delete files 
sh ( I ) : command 
intr(ll): catch or inhibit 
split(l): break a file 



encrypt according to a 



:(l): place 

fed(l): form 
forml(l): generate form 



get execution times 
get file status 
get file status 
get process status 
get time information 
get time of year 
get typewriter mode 
get user ID 

getc(lll): get character 
getty(VIl): adapt to typewriter 
getuid(ll): get user ID 
glob(VIl): argument expander 
goto(l): command transfer 
greek(VIl): extended TTY 37 typebox 
gtty(ll): get typewriter mode 
headings 

hierarchy. • •dcheck( VIII) : 
hyphenated words 

hyphen(l): find hyphenated words 
hypotenuse 

hypot(lll): compute hypotenuse 

i-node 

i -number 

ID 

ID 

if(l): conditional command 

ilgins(ll): catch illegal instruction 

illegal instruction trap 

image file 

in a file 

index 

information 

information 

inhibit interrupts 

inhibit quits 

initializer process 

init(VIl)! initializer process 

instruction trap 

integer to ASCII 

integer 

inter process chauinel 

interactively 

interpreter 

interrupts 

into pieces 

intr(Il): catch or inhibit interrupts 

istat(VIII): file status by i-number 

itoa(lll): convert integer to ASCII 

keyword . . • cr ypt ( I I I ) : 

kill (II): destroy process 

kill ( VIII): terminate a process 

kl(lV): console typewriter 

label 

ld(l): link editor (loader) 

letter editor 

letters 



map 



trap 
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formd): generate form 
uniq(l): find duplicate 

Idd): 
link(ll) ! 
ln(l)j 

ls(l): 

nlist(lll)! read name 

dli(VIIl) : 
a,out(v) : assembler and 
ld(l) : link editor 
login(l): 
logdll): 
utmp(v) ! 

passwdd ) : set 

nice(ll ) : set 



m6(l) : 

tap(v) : DECtape and 
mt(l): save, restore files on 
tm(iv) : g-track 
mail(l): send 



rnand ) : run off 
ascii(VIl) : 
extended TTY 37 typebox 



mem(lV) ; core 



raesg(l): permit or deny 
tss(l): communicate with 
msh(vil) : 

chmod(l) ; change access 
chmoddl): change 
stty(ll) : set 
sttyd); set typewriter 
gtty(ll): get typewriter 
mdate(ll): set date 
mount (II) : 
mount (VIII): 



mv(l ) : 
seek(ll) : 



letter 

lines in a file 

link editor (loader) 

link to file 

link to file 

link(ll): link to file 

list contents of directory 

list 

ln(l) : link to file 

load DEC binary paper tapes 

loader output 

(loader) 

log on to system 

logarithm base e 

logged-in user information 

logflll); logarithm base e 

login password 

login(l): log on to system 

low-priority status 

ls(I): list contents of directory 

m6(l); macroprocessor 

macroprocessor 

magtape format 

magtape 

magtape 

mail to another user 

mail(l)! send mail to another user 

makdir(ll): create directory 

man(l): run off manual section 

manual section 

map of ASCII 

map. • •greek(VII ) : 

mdate(ll): set date modified of file 

mem(iv) ; core memory 

memory 

mesgd); permit or deny messages 
mesg(lll)s print string on typewriter 
messages 
MH-TSS (GCOS) 
mini Shell 

mkdir(l)! create directory 

mode of files 

mode of file 

mode of typewriter 

modes 

mode 

modified of file 

mount file system 

mount removable file system 

mount (II): mount file system 

mount ( VIII): mount removable file system 

move or rename file 

move read or write pointer 

msh(VIl): mini Shell 

mt(l): save, restore files on magtape 
mv(l); move or rename file 
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nlist(lll): read 
tty(l); find 
nm(l): print 
ttyndll): find teletype 

fork(Il): create 



rand(lll): pseudo random 
pow(lll); take powers of 
factor(l): factor a 
reloc(l): relocate 
odd): 

convert floating to 

man(l): run 
opr(l): print file 
close(ll): close 
dup(ll): duplicate an 
fstat(ll): status of 
open( II ) : 
pipe(Il)s 



cat(l): concatenate 
ecvt(lll): edited 
assembler and loader 
ov ( I ) : page 

chown ( I ) : change 
chown(ll): change 
ov(l): 

type(l): print file 
dli(VIII): load DEC binary 
pc(lV): punched 



passwd(V)! 
passwd(l): set login 

mesg( I) : 
ptx(Vl): 

generate voice synthesizer 
vsp(VIl); voice synthesizer 
display character on 
split(l); break a file into 

:(I): 

seek(ll): move read or write 
pow(lll)! take 



echo ( I ) : 
opr(l): 
typed ) ! 



name list 

name of terminal 

namelist 

name 

new process 

nice (II): set low-priority status 

nlist(lll): read name list 

nm(l): print namelist 

nroff(l): format text for printing 

nijmber generator 

numbers 

number 

object files 

octal dump of file 

octal. • .f too(lII ) : 

od(l): octal dump of file 

off manual section 

off-line 

open file 

open file 

open file 

open file 

open inter process channel 

open(ll): open file 

opr(l): print file off-line 

(or print) files 

output conversion 

output . . . a . out ( V ) : 

overlay file print 

ov(l): page overlay file print 

owner of files 

owner of file 

page overlay file print 

page-by-page 

paper tapes 

paper tape 

passwd(l): set login password 
passwd(V): password file 
password file 
password 

pc(lV): punched paper tape 
permit or deny messages 
permuted index 
phonemes, . .vs( I ) : 
phonemes 

Picturephone. • .ddsput( III) : 
pieces 

pipe(ll): open inter process channel 

place label 

pointer 

powers of numbers 

pow(lll): take powers of numbers 

pr(l): print file with headings 

print command arguments 

print file off-line 

print file page-by-page 
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pr(l): 
nra ( I ) : 
mesg( III ) : 
ptime( III ) : 
cat(l): concatenate (or 
nroff(l): format text for 
roff(l): format text for 
ov(l): page overlay file 
bproc ( VII I ) : boot 
pipe(ll): open inter 
ps(VIIl): get 
rele(ll): release 
fork(ll): create new 
init(VIl): initializer 
kill (II): destroy 
kill(VIIl): terminate a 
wait(Il): wait for 
break(ll): set 
exec (II): execute 
size(l): get executable 
bc(Vl): compile B 
cc( I ) : compile C 
fed): compile Fortran 
sno(l): compile Snobol 
tmg(l): compile tmgl 

rand(lll): 



pc(lV) : 



qsort ( III) : 

quit(ll) : inhibit 

rand (III): pseudo 
read (II): 
nlist(lll) : 
seek (II): move 
csw(ll): 

20boot(VIll): 
boot(ll) : 
cref(l): cross 
rele(ll): 

reloc(l): 
strip(l): remove symbols, 

dc(lV): 
mount(VIIl): mount 
rmdir(l): 
rm(l): 
unlink(ll) : 



print file with headings 

print namelist 

print string on typewriter 

print time 

print) files 

printing 

printing 

print 

procedure 

process channel 

process status 

processor 

process 

process 

process 

process 

process 

program break 

program file 

program size 

program 

program 

program 

program 

program 

proof(l): compare text files 

pseudo random number generator 

ps(VIIl): get process status 

ptime(lll): print time 

ptx(Vl): permuted index 

punched paper tape 

putc(lll): write character or word 

qsort (I II): quicker sort 

quicker sort 

quit(ll): inhibit quits 

quits 

rand(lll): pseudo random number generator 

random number generator 

read file 

read name list 

read or write pointer 

read the console switches 

read(ll): read file 

reboot 11/20 system 

reboot the system 

reference table 

release processor 

rele(ll): release processor 

relocate object files 

relocation bits 

reloc(l): relocate object files 
remote typewriter 
removable file system 
remove (delete) directory 
remove (delete) file 
remove (delete) file 
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strip (I ) : 
rav( I ) ! move or 
salv(VIIl) : 
tap(l): save, 
mt(l): save, 

rew( I ) : 
rf(lV): 

rk(iv): 



sqrt(lll): square 
man ( I ) : 



tap(l): 
mt ( I ) : 

roan(l): run off manual 

mail (I): 
speakd ) : 
exit(l): end command 
mdate(ll): 
passwd ( I ) : 
nice(ll) : 
stty(ll): 
break ( II ) : 
stime(ll): 
tabs (VII): 
stty(l): 
setuid(ll): 

msh(Vll): mini 

sin(lll): 



get executable program 

sno(l): compile 

sort(l): 

string compare for 
qsort(lll): quicker 
df(l): find free disk 
dpd(VIl) : 



sqrt(lll) ! 



remove symbols, relocation bits 
rename file 

repair damaged file system 
restore files on DECtape 
restore files on magtape 
rew(l): rewind DECtape 
rewind DECtape 
RF disk 

rf(lV): RF disk 
RK disk 

rk(lV): RK disk 

rmdir(l): remove (delete) directory 
rm(l); remove (delete) file 
roff(l): format text for printing 
root 

run off manual section 
salloc(lll): storage allocator 
salv(VIIl): repair damaged file system 
save, restore files on DECtape 
save, restore files on magtape 
section 

seek ( II): move read or write pointer 

send mail to another user 

send words to voice synthesizer 

sequence 

set date modified of file 

set login password 

set low-priority status 

set mode of typewriter 

set program break 

set system time 

set tab stops on typewriter 

set typewriter modes 

set user ID 

setuid(ll): set user ID 
Shell 

sh(l): command interpreter 

sine, cosine 

sin (III): sine, cosine 

sized ): get executable program size 

size, • • size( I ) : 

sleep(ll): delay execution 

Snobol program 

sno(l): compile Snobol program 

sort ASCII file 

sort(l): sort ASCII file 

sort. . •compar( III) : 

sort 

space 

spawn dataphone daemon 

speak(l): send words to voice synthesizer 
split(l): break a file into pieces 
sqrt(lll): square root 
square root 

Stat (I): get file status 
Stat (II): get file status 
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istat(VIIl): file 
f stat( II) : 
nice(ll): set low-priority 
ps(VIIl): get process 
stat(l): get file 
stat(ll): get file 

tabs(VIl) I set tab 
salloc(lll): 
vt(lV): 
compar (III) ; 
mesg(lll): print 



sum ( I ) : 

csw(ll): read the console 

db(l): 
strip(l): remove 
un(l): find xindefined 
sync(ll): assure 

vs(l): generate voice 
vsp(VIl): voice 
speak(l): send words to voice 
file system(v): file 
stime(ll): set 
chk(VIIl): check all file 

file 

20boot(VIIl) : reboot 11/20 
boot(ll): reboot the 
check consistency of file 
login(l): log on to 
mount(ll): mount file 
mount removable file 
repair damaged file 
umount(ll): dismount file 
who ( I ) : who i s on the 
tabs(VIl): set 
cref(l): cross reference 

pow(lll): 
load DEC binary paper 
pc(lV): punched paper 



ttyn(lll): find 
tty(l): find name of 
kill(VIIl): 
exit(ll): 
ed(l): 

proof (I): compare 
nroff(l): format 



status by i-number 

status of open file 

status 

status 

status 

status 

stime(ll): set system time 
stops on typewriter 
storage allocator 
storage-tube display 
string compare for sort 
string on typewriter 

strip(l): remove symbols, relocation bits 
stty(l): set typewriter modes 
stty(ll): set mode of typewriter 
sum file 

sum( I ) : sum file 
switches 

switch (III): transfer depending on value 
symbolic debugger 
symbols, relocation bits 
symbol s 

synchr on iz at ion 

sync( II): assure synchronization 

synthesizer phonemes 

synthesizer phonemes 

synthesizer 

system format 

system time 

systems 

system(V): file system format 

system 

system 

system, • ♦check(VIIl) : 

system 

system 

system. • •mount(VIIl) : 
system. salv( VIII ) : 
system 
system 

tab stops on typewriter 
table 

tabs(VIl): set tab stops on typewriter 
tsOce powers of numbers 
tapes... dli(VIIl): 
tape 

tap(l): save, restore files on DECtape 
tap(V): DECtape and magtape format 
tc(lV): DECtape 
teletype name 
terminad 

terminate a process 

terminate execution 

text editor 

text files 

text for printing 
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roff(l): format 
timed ) ; get 
date(l); get date and 
time(ll ) : get 
ctime(lll): convert 



times ( II ): get execution 
ptimeClIl): print 
stime(ll); set system 



tmgd); compile 
switch(lll): 
goto ( I ) ! command 
cemt(ll): catch EMT 
catch illegal instruction 

greek (VI I ) ! extended 



greek(VIl): extended TTY 37 

sttyd ) ! set 
gtty(ll) : get 
dcClv) ! remote 
getty(VIl): adapt to 
kl(iv) : console 
mesg(lll): print string on 
stty(ll): set mode of 
tabs ( VII ): set tab stops on 
typo(l) : find 



un(l): find 



du(l) : find disk 
getuid(ll) : get 
setuid(ll) I set 
utmp(V) : logged-in 
mail(l) : send mail to another 
write(l); write to another 

transfer depending on 
dcheck(vill) : 
vs(l ) : generate 
vsp(VII): 
speak(l): send words to 



waitdl ) : 



text for printing 
time information 
time of day 
time of year 
time to ASCII 

timed ): get time information 

time(ll): get time of year 

times(ll): get execution times 

times 

time 

time 

tm(iv): 9-track magtape 
tmgd): compile tmgl program 
tmgl program 

transfer depending on value 

transfer 

traps 

trap.. ,ilgins(ll) : 

tss(l): communicate with MH-TSS (GCOS) 
TTY 37 type box map 
tty(l): find name of terminal 
ttyndll): find teletype name 
typebox map 

type(l): print file page-by-page 

typewriter modes 

typewriter mode 

typewriter 

typewriter 

typewriter 

typewriter 

typewriter 

typewriter 

typographic errors 

typo(l): find typographic errors 

umount(ll)! dismount file system 

undefined symbols 

un(l): find undefined symbols 

uniq(l): find duplicate lines in a file 

unlink(ll) : remove (delete) file 

usage 

user ID 

user ID 

user information 

user 

user 

utmp(v) : logged-in user information 

value.. .switch( III ): 

verify directory hierarchy 

voice synthesizer phonemes 

voice synthesizer phonemes 

voice synthesizer 

vs(l): generate voice synthesizer phoneme 
vsp(VIl): voice synthesizer phonemes 
vtdv) : storage-tube display 
wait for process 
wait(ll): wait for process 
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who ( I ) : 

gerts(lll): communicate 
pr(l): print file 
tss(l): communicate 
wc(l): get (English) 
speak(l ) : send 
hyphen ( I ) : find hy ph en at ed 
putc(lll): write character or 
chdir(l): change 
chdir ( II ) : change 
putc(lll) ; 
write(ll): 
seek ( II): move read or 
write(l): 



time ( II): get time of 
yacc( VI ) : 



wc(l): get (English) word count 

who is on the system 

who(l): who is on the system 

with GCOS 

with headings 

with MH-TSS (GCOS) 

word count 

words to voice synthesizer 

words 

word 

working directory 

working directory 

write character or word 

write file 

write pointer 

write to another user 

write(l): write to another user 

write(ll): write file 

wtmp(V): accounting files 

yacc(Vl): yet another compiler -compiler 

year 

yet another compiler -compiler 
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NAME : — place a label 

SYNOPSIS J [ label ] 

DESCRIPTION The purpose ot ± is to place a label for the goto 

command. It has no effect when executed. 

FILES 

SEE ALSO goto(l) 
DIAGNOSTICS - 
BUGS 
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NAME ar — archive 

SYNOPSIS ar key afile name^ ... 

DESCRIPTION ar maintains groups of files combined into a sin- 
gle archive file. Its main use is to create and 
update library files as used by the loader. It 
can be used, though, for any similar purpose. 

key is one character from the set drtux, option- 
ally concatenated with v. afile is the archive 
file. The names are constituent files in the 
archive file. The meanings of the key characters 
are : 

d means delete the named files from the archive 
file. 

r means replace the named files in the archive 
file. If the archive file does not exist, r will 
create it. If the named files are not in tTie 
archive file, they are appended. 

t prints a table of contents of the archive file. 
If no names are given, all files in the archive 
are tabled. If names are given, only those files 
are tabled. 

u is similar to r except that only those files 
that have been modified are replaced. If no 
names are given, all files in the archive that 
have been modified will be replaced by the modi- 
fied version. 

X will extract the named files. If no names are 
given, all files in the archive are extracted. 
In neither case does x alter the archive file. 

V means verbose. Under the verbose option, ar 
gives a file-by-file description of the making of 
a new archive file from the old archive and the 
constituent files. The following abbreviations 
are used: 

c copy 
a append 
d delete 
r replace 
X extract 

/tmp/vtm? temporary 

ld(l) , archive (V) 

[[Bad usage", "afile — not in archive format" 
"cannot open temp file", "name — cannot open , 



FILES 

SEE ALSO 

DIAGNOSTICS 
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"name — phase error", "name — cannot create**!^ 
"no archive file", ^"cannot create archive file , 
"name — not found". 

BUGS Option vt should be implemented as a table with 

more information. 



There should be a way to specify the placement of 
a new file in an archive. Currently, it is 
placed at the end. 

"ar x" changes the modif ied-date of the current 
directory to a random number. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 



DIAGNOSTICS 



as — assembler 
as [ ~ ] name^ 
as assembles the concatenation of name 



11 



If 



the optional first argument - is used, all unde- 
fined symbols in the assembly are treated as glo- 
bal. 

The output of the assembly is left on the file 
"a .out". It is executable if no errors occurred 
during the assembly. 



/etc/as2 
/tmp/atm1 ? 
/tmp/atm2? 
/tmp/atm3? 
a. out 



pass 2 of the assembler 

temporary 

temporary 

temporary 

object 



ld(l), nm(l), unj^l), db(l), a.out(v), "UNIX 
Assembler Manual . 

When an input file cannot be read, its name fol- 
lowed by a question mark is typed and assembly 
ceases* When syntactic or semantic errors occur, 
a single-character diagnostic is typed out to- 
gether with the line number and the file name in 
which it occurred. Errors in pass 1 cause can- 
cellation of pass 2* The possible errors are: 

) parentheses error 

] parentheses error 

< String not terminated properly 

♦ Indirection used illegally 

• Illegal assignment to 
A error in Address 

B Branch instruction is odd or too remote 

E error in Expression 

F error in local ( F or b ) type symbol 

G Garbage (unknown) character 

I End of file inside an If 

M Multiply defined symboT"as label 

O Odd— word quantity assembled at odd address 

P Phase error — different in pass 1 and 2 

R Relocation error 

U Undefined symbol 

X syntax error 



BUGS 



Symbol table overflow is not checked, 
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NAME bas — basic 

SYNOPSIS bas [ file ] 

DESCRIPTION bas is a dialect of basic [1] . If a file argu- 
ment is provided, the file is used for input 
before the console is read, 

bas accepts lines of the form: 

statement 
integer statement 

Integer numbered statements (known as internal 
statements) are stored for later execution. They 
are stored in sorted ascending order. Non- 
numbered statements are immediately executed. 
The result of an immediate expression statement 
(that does not have as its highest operator) 
is printed. 

Statements have the following syntax: 

expression 

The expression is executed for its side 
effects (assignment or function call) or 
for printing as described above. 

done 

Return to system level. 

draw expression expression expression 
A line is drawn on the Tektronix 611 
display (/dev/vtO) from the current display 
position to the XY co-ordinates specified 
by the first two expressions. (The scale 
is zero to one in both X and Y directions) 
If the third expression is zero, the line 
is invisible. The current display position 
is set to the end point.. 

display list 

The list of expressions and strings is con- 
catenated and displayed (i.e. printed) on 
the 61 1 starting at the current display 
position. The current display position is 
not changed. 

erase 

The 611 screen is erased. 

for name a expression expression statement 
for name = expression expression 

• • • 
next 

The for statement repetitively executes a 
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statement (first form) or a group of state- 
ments (second form) under control of a 
named variable. The variable takes on the 
value of the first expression, then is 
incremented by one on each loop, not to 
exceed the value of the second expression. 

croto expression 

The expression is evaluated, truncated to 
an integer and execution goes to the 
corresponding integer numbered statment. 
If executed from immediate mode, the inter- 
nal statements are compiled first. 

if expression statement 

The statement is executed if the expression 
evaluates to non-zero. 

list [expression [expression]] 

list is used to print out the stored inter- 
nal statements. If no arguments are given, 
all internal statements are printed, if 
one argument is given, only that internal 
statement is listed. If two arguments are 
given, all internal statements inclusively 
between the arguments are printed. 

print list 

The list of expressions and strings are 
concatenated and printed. (a string is 
delimited by " characters.) 

return [expression] 

The expression is evaluated and the result 
is passed back as the value of a function 
call, if no expression is given, zero is 
returned. 

run 

The internal statements are compiled. The 
symbol table is re-initialized. The random 
number generator is re-set. Control is 
passed to the lowest numbered internal 
statement. 

Expressions have the following syntax: 

name 

A name is used to specify a variable. 
Names are composed of a letter ('a' - * z* ) 
followed by letters and digits. The first 
four characters of a name are significant. 

number 

A number is used to represent a constant 
value. A number is composed of digits, at 
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most one decimal point ('.') and possibly a 
scale factor of the form e digits or e- 
digits. 

£ expression J 

parentheses are used to alter normal order 
of evaluation. 

expression operator expression 

Common functions of two arguments are ab- 
breviated by the two arguments separated by 
an operator denoting the function. A com- 
plete list of operators is given below. 

expression ^ [expression [j^ expression •••]] 
Functions of an arbitrary number of argu- 
ments can be called by an expression fol- 
lowed by the arguments in parentheses 
separated by commas. The expression evalu- 
ates to the line number of the entry of the 
function in the internally stored state- 
ments. This causes the internal statements 
to be compiled. If the expression evalu- 
ates negative, a builtin function is 
called. The list of builtin functions 
appears below. 

name X expression [j, expression ...] X 

Each expression is truncated to an integer 
and used as a specifier for the name. The 
result is syntactically identical to a 
name. a[1 ,2] is the same as a[l][2]. The 
truncated expressions are restricted to 
values between and 32767. 

The following is the list of operators: 



«s is the assignment operator. The left 
operand must be a name or an array element. 
The result is the right operand. Assign- 
ment binds right to left, all other opera- 
tors bind left to right. 

& j 

& (logical and) has result zero if either 
of its arguments are zero. It has result 
one if both its arguments are non-zero. 
(logical or) has result zero if both of its 
arguments are zero. It has result one if 
either of its arguments are non-zero. 

< <= > >= <> 

The relational operators (< less than, <= 
less than or equal, > greater than, >= 
greater than or equal, == equal to, <> not 
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equal to) return one if their arguments are 
in the specified relation. They return 
zero otherwise. Relational operators at 
the same level extend as follows: a>b>c is 
the same as a>b&b>c. 



+ - 



Add and subtract. 



/ 



Multiply and divide. 



FILES 

SEE ALSO 

DIAGNOSTICS 



Exponentiation. 
The following is a list of builtin functions: 
arg 

Arg(i) is the value of the ith actual 
parameter on the current level of function 
call . 



exp 



Exp(x) is the exponential function of x. 



log 



Log(x) is the logarithm base e of x. 



sin 



Sin(x) is the sine of x (radians). 



cos 



Cos(x) is the cosine of x (radians). 



atn 



Atn(x) is the arctangent of x. 



rnd 



Rnd() is a uniformly distributed random 
number between zero and one. 



expr 



Expr( ) is the only form of program input. 
A line is read from the input and evaluated 
as an expression. The resultant value is 
returned. 

int 

Int(x) returns x truncated to an integer. 
/t«p/btm? temporary 
[1] DEC-1 1 -AJPB-D 

Syntax errors cause the incorrect line to be 
typed with an underscore where the parse failed. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



cat — concatenate and print 
cat f ile^ , , . 

cat reads each file in sequence and writes it on 
the standard output. Thus? 

cat file 

is about the easiest way to print a file. Also: 

cat f ilel file2 >f ile3 

is about the easiest way to concatenate files. 

If no input file is given cat reads from the 
standard input file. 

If the argument is encountered, cat reads 

from the standard input file. 



pr(l), cp(l) 

none; if a file cannot be found it is ignored. 

cat X y >x and cat x y >y cause strange 
results. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 

DIAGNOSTICS 

BUGS 



CC — C compiler 

CC [ ] sfile^^^ ... ofile^ ... 

cc is the UNIX C compiler. It accepts three 
types of arguments: 

Arguments whose names end with **«c** are assumed 
to be C source programs; they are compiled, and 
the object program is left on the file sf ile. 
(i.e.^ the file whose name^is^that of the source 
with "•o" substituted for "•c"). 

Other arguments (except for "-c") are assumed to 
be either loader flag arguments, or C-compatible 
object programs, typically produced by an earlier 
CC run, or perhaps libraries of C-compatible 
routines. These programs, together with the 
results of any compilations specified, are loaded 
(in the order given) to produce an executable 
program with name a .out . 

The "-c" argument suppresses the loading phase, 
as does any syntax error in any of the routines 
being compiled. 



f ile.c 
file ,o 
a, out 

/ tmp/ctm? 
/lib/c [01] 
/lib/crtO.o 
/lib/libc.a 
/lib/liba.a 



input file 

object file 

loaded output 

temporary 

compiler 

runtime startoff 

bull tin functions, etc 

system library 



C reference manual (in preparation), cdb(i) 
Diagnostics are intended to be self-explanatory 
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NAME 

SYNOPSIS 
DESCRIPTION 



cdb — C debugger 

cdb [ core [ a .out ] ] 

cdb is a debugging program for use with C pro- 
grams. It is by no means completed, and this 
section is essentially only a placeholder for the 
actual description. 

Cdb resembles db in many respects, except that 
all integers are decimal. 

Even the present cdb has one useful feature: the 
command 



$ 

will give a stack trace of the core image of a 
terminated C program. The calls are listed in 
the order made; the actual arguments to each 
routine are given in octal. 

FILES 

SEE ALSO cc(l), db(l), C Reference Manual 

DIAGNOSTICS 

BUGS — 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



chdir — change working directory 
chdir directory 

directory becomes the new working directory. 

Because a new process is created to execute each 
command, chdir would be ineffective if it were 
written as a normal command. It is therefore 
recognized and executed by the Shell, 



sh(l) 

"Bad directory' 
changed to. 



if the directory cannot be 



BUGS 
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NAME 

SYNOPSIS 

DESCRIPTION 



chmod — change mode 
chmod octal file^ ... 

The octal mode replaces the mode of each of the 
files. The mode is constructed from the OR of. 
the following modes: 

01 write for non-owner 

02 read for non-owner 
04 write for owner 

10 read for owner 
20 executable 
40 set-UID 

Only the owner of a file may change its mode. 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



stat(l), ls(l) 
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NAME 

SYNOPSIS 

DESCRIPTION 



chown 



FILES 

SEE ALSO 

DIAGNOSTICS 



Change owner 



chown owner file 



owner becomes the new owner of the files. The 
owner may be either a decimal UID or a login name 
found in the password file. 

Only the owner of a file is allowed to change the 
owner. It is illegal to change the owner of a 
file with the set-user-ID mode. 

/etc/pa sswd 

stat(l) 

"who?" if owner cannot be found, 
cannot be found. 



file? if file 



BUGS 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



cmp — compare two files 
cmp file^ ^^^®2 

The two files are compared for identical con- 
tents. Discrepancies are noted by giving the 
offset and the differing words, all in octal. 



proof (I ) 

Messages are given for inability to open either 
argument, premature EOF on either argument, and 
incorrect usage. 

If the shorter of the two files is of odd length, 
cmp acts as if a null byte had been appended to 
it. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



cp — copy 

£2 file^ fi^®2 

The first file is copied onto the second. The 
mode and owner of the target file are preserved 
if it already existed; the mode of the source 
file is used otherwise. 

If file^ is a directory, then the target file is 
a file In that directory with the file-name of 
file^ . 



cat(l), pr(l), mv(l) 

Error returns are checked at every system call, 
and appropriate diagnostics are produced. 

Copying a file onto itself destroys its contents. 
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NAME 

SYNOPSIS 
DESCRIPTION 



cref — make cross reference listing 
cref [ -soi ] name1 ... 

CREF makes a cross reference listing of files in 
assembler format (see AS(l)). The files named as 
arguments in the command line are searched for 
symbols (defined as a succession of alphabetics, 
numerics, or * beginning with an alpha- 

betic, or 

The output report is in four columns: 



(1) 

symbol 



(2) 
file 



(3) 
see 
below 



(4) 
text 



as it appears in file 



The third column contains the line number in the 
file by default; the ^ option will cause the 
most recent name symbol to appear there instead. 

CREF uses either an ignore file or an only file. 
If the option is given, it will take the next 
file name to be an ignore file; if the ^ option 
is given, the next file name will be taken as an 
only file. Ignore and only files should be lists 
of symbols separated by new lines. If an ignore 
file is given, all the symbols in the file will 
be ignored in columns (1) and (3) of the output. 
If an only file is given, only symbols appearing 
in the file will appear in column (l), but column 
(3) will still contain the most recent name en- 
countered. Only one of the options :;i or ^ may 
be used. The default setting is ^; all symbols 
predefined in the assembler are ignored, except 
system call names, which are collected. 

FILES Files t.O. t.1 , t.2, t.3 are created (i.e. 

destroyed) in the working directory of anyone 
using cref . This nuisance will be repaired soon. 
The output is left in file s.out in the working 
directory. 

/usr/lem/s.tab is the default ignore file. 
SEE ALSO as(l) 

DIAGNOSTICS "line too long" — input line >1 31 characters 

"symbol too long" — symbol >20 characters 
"too many symbols" — >1 symbols in line 
"cannot open t.?" — bug; see LEM 
"cannot fork; examine t.out" ■ — can't start sort 
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process; intermediate results are on files 
t,0 « t,1 > t,2 » t«3 . These may be sorted in- 
dependently and the results concatenated by 
the user, 

"cannot sort" — odd response from sort ; examine 
intermediate results , as above. 

"impossible situation" — system bug 

"cannot open" file — one of the input names 
cannot be opened for reading. 

BUGS The destruction of unsuspecting users' files 

should soon be fixed. A limitation that may 
eventually go away is the restriction to assem- 
bler language format. There should be options for 
FORTRAN, English, etc., lexical analysis. 

File names longer than eight characters cause 
misalignment in the output if tabs are set at 
every eighth column. 

It should write on the standard output, not 
s.out. 
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NAME 

SYNOPSIS 
DESCRIPTION 



crypt encode/decode 
crypt [ password ] 

crypt is an exact implementation of Boris 
Hagelin's cryptographic machine called the M-209 
by the U» S. Army 

crypt reads from the standard input file and 
writes on the standard output. For a given pass- 
word, the encryption process is idempotent; that 
is, 

crypt znorkle <clear >cypher 
crypt znorkle <cypher 

will print the clear. 

crypt is suitable for use as a filter: 

pr <" crypt bandersnatch"<cypher 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



[1] U. S. Patent 2,089,603. 
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NAME 

SYNOPSIS 

DESCRIPTION 



date — print and set the date 
date [ mmddhhmm ] 

If no argument is given, the current date is 
printed to the second. If an argument is given, 
the current date is set, mm is the month number; 
dd is the day number in the month; 2ib is the hour 
number (24 hour system); mm is the minute number. 
For example: 

date 10080045 

sets the date to Oct 8, 12:45 AM. 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



? if the argument is syntactically incorrect. 
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NAME db — debug 

SYNOPSIS db [ core [ namelist ] ] [ - ] 

DESCRIPTION Unlike many debugging packages (including DEC's 

ODT, on which db is loosely based) db is not 
loaded as part of the core image which it is used 
to examine; instead it examines files. Typical- 
ly, the file will be either a core image produced 
after a fault or the binary output of the assem- 
bler^j Core is the file being debugged; if omit- 
ted core" is assumed, namelist is a file con- 
taining a symbol table. If it is omitted, the 
symbol table is obtained from the file being 
debugged, or if not there from a .out . If no 
appropriate name list file can be found, db can 
still be used but some of its symbolic facilities 
become unavailable. 

For the meaning of the optional third argument, 
see the last paragraph below. 

The format for most db requests is an address 
followed by a one character command. 

Addresses are expressions built up as follows: 

1 . A name has the value assigned to it when 
the input file was assembled. It may be 
relocatable or not depending on the use of 
the name during the assembly. 

2. An octal number is an absolute quantity 
with the appropriate value. 

3. A decimal number immediately followed by 

is an absolute quantity with the ap- 
propriate value. 

4. An octal number immediately followed by "r" 
is a relocatable quantity with the ap- 
propriate value. 

5. The symbol indicates the current 
pointer of db. The current pointer is set 
by many db requests . 

6. A before an expression forms an expres- 
sion whose value is the number in the word 
addressed by the first expression. A 
alone is equivalent to . 

6. Expressions separated by or " " (blank) 
are expressions with value equal to the sum 
of the components. At most one of the com- 
ponents may be relocatable. 
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8. Expressions separated by form an ex- 
pression with value equal to the difference 
to the components. If the right component 
is relocatable, the left component must be 
relocatable, 

9. Expressions are evaluated left to right. 
Names for registers are built in: 

rO ... r5 

sp 
pc 

frO ... fr5 

These may be examined. Their values are deduced 
from the contents of the stack in a core image 
file. They are meaningless in a file that is not 
a core image. 

If no address is given for a command, the current 
address (also specified by ".") is assumed. In 
general, points to the last word or byte 

printed by db. 

There are db commands for examining locations 
interpreted as octal numbers, machine instruc- 
tions, ASCII characters, and addresses. For 
numbers and characters, either bytes or words may 
be examined. The following commands are used to 
examine the specified file. 

/ The addressed word is printed in octal. 

\ The addressed byte is printed in octal. 

The addressed word is printed as two ASCII 
characters. 

* The addressed byte is printed as an ASCII 
character. 

* The addressed word is printed in decimal. 

? The addressed word is interpreted as a 

machine instruction and a symbolic form of 
the instruction, including symbolic ad- 
dresses, is printed. Often, the result 
will appear exactly as it was written in 
the source program. 

& The addressed word is interpreted as a sym- 
bolic address and is printed as the name of 
the symbol whose value is closest to the 
addressed word, possibly followed by a 
signed offset. 
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<nl> (i. e., the character new line") This 
command advances the current location 
counter and prints the resulting loca- 
tion in the mode last specified by one of 
the above requests. 

^ This character decrements and prints 
the resulting location in the mode last 
selected one of the above requests. It is 
a converse to <nl>. 

% Exit. 

Odd addresses to word-oriented commands are 
rounded down. The incrementing and decrementing 
of done by the <nl> and ^ requests is by one 

or two depending on whether the last command was 
word or byte oriented. 

The address portion of any of the above commands 
may be followed by a comma and then by an expres- 
sion. In this case that number of sequential 
words or b^tes specified by the expression is 
printed. is advanced so that it points at 

the last thing printed. 

There are two commands to interpret the value of 
expressions. 

a When preceded by an expression, the value 
of the expression is typed in octal. When 
0Oj preceded by an express ion , the value of 

. is indicated. This command does not 
change the value of 

: An attempt is made to print the given ex- 
pression as a symbolic address. If the 
expression is relocatable , that symbol is 
found whose value is nearest that of the 
expression, and the symbol is typed, fol- 
lowed by a sign and the appropriate offset. 
If the value of the expression is absolute, 
a symbol with exactly the indicated value 
is sought and printed if found; if no 
matching symbol is discovered, the octal 
value of the expression is given. 

The following command may be used to patch the 
file being debugged. 

! Thi^ con^and must be preceded by an expres- 
siSb value of the expression is 

stoKd#it the location addressed by the 
curJ^^I ^lue of **.**. The opcodes do not 
appear iffil^ symbol table, so the user 
must assemble them lq|^^hand. 
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The following command is used after a fault has 
caused a core image file to be produced. 

$ causes the fault type and the contents of 
the general registers and several other 
registers to be printed both in octal and 
symbolic format. The values are as they 
were at the time of the fault. 

Db should not be used to examine special files, 
for example disks and tapes, since it reads one 
byte at a time. Use od(l) instead. 

For some purposes, it is important to know how 
addresses typed by the user correspond with loca- 
tions in the file being debugged. The mapping 
algorithm employed by db is non-trivial for two 
reasons: First, in an a .out file, there is a 
20(8) byte header which will not appear when the 
file is loaded into core for execution. There- 
fore, apparent location should correspond with 
actual file offset 20. Second, some systems 
cause a "squashed" core image to be written, in 
such a core image, addresses in the stack must be 
mapped according to the degree of squashing which 
has been employed. Db obeys the following rules: 

If exactly one argument is given, and if it ap- 
pears to be an a .out file, the 20-byte header is 
skipped during addressing, i.e., 20 is added to 
all addresses typed. As a consequence, the 
header can be examined beginning at location -20. 

If exactly one argument is given and if the file 
does not appear to be an a .out file, no mapping 
is done. 

If zero or two arguments are given, the mapping 
appropriate to a core image file is employed. 
This means that locations above the program break 
and below the stack effectively do not exist (and 
are not, in fact, recorded in the core file). 
Locations above the user's stack pointer are 
mapped, in looking at the core file, to the place 
where they are really stored. The per-process 
data kept by the system, which is stored in the 
last 512(10) bytes of the core file, can be ad- 
dressed at apparent locations 160000-160777. 

If one wants to examine a file which has an asso- 
ciated name list, but is not a core image file, 
the last argument can be used (actually the 
only purpose of the last argument is to make the 
number of arguments not equal to two). This 
feature is used most frequently in examining the 
memory file /dev/mero. 
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FILES 

SEE ALSO as(l), core(v), a.out(v), od(l) 

DIAGNOSTICS "File not found^^ij the first argument cannot be 

read; otherwise "? , 

BUGS 
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NAME dc — desk calculator 

SYNOPSIS dc [file] 

DESCRIPTION dc is an arbitrary precision integer arithmetic 

package. The overall structure of dc is a stack- 
ing (reverse Polish) calculator. The following 
constructions are recognized by the calculator: 

number 

The value of the number is pushed on the 
stack. A number is an unbroken string of the 
digits 0-9. It may be preceded by an under- 
score (_) to input a negative number. 

± = 1 I %Z 

The top two values on the stack are added (+), 
subtracted (-), multiplied (*), divided (/)7 
remaindered J%) or exponentiated C^). The two 
entries are popped off the stack; the result 
is pushed on the stack in their place. 

sx 

" The top of the stack is popped and stored into 
a register named x, where x may be any charac- 
ter. 

Ix 

The value in register x is pushed on the 
stack. The register x is not altered. All 
registers start with zero value. 

d 

The top value on the stack is pushed on the 
stack. Thus the top value is duplicated. 

B 

The top value on the stack is printed. The 
top value remains unchanged. 

f 

All values on the stack and in registers are 
printed, 

a 

exits the program. If executing a string, the 
nesting level is popped by two. 

2S 

~ treats the top element of the stack as a char- 
acter string and executes it as a string of dc 
commands. 

r...i 

puts the bracketed ascii string onto the top 
of the stack. 
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«x 2x 

The top two elements of the stack are popped 
and compared^ Register x is executed if they 
obey the stated relation. 

V 

~ replaces the top element on the stack by its 
square root • 



interprets the rest of the line as a UNIX com- 
mand . 

c 

" All values on the stack are popped. 



The top value on the stack is popped and used 
as the number radix for further input. 

o 

the top value on the stack is popped and used 
as the number radix for further output. 

z 

the stack level is pushed onto the stack. 

? 

a line of input is taken from the input source 
(usually the console) and executed. 

new-line 

ignored except as the name of a register or to 
end the response to a ?. 

space 

ignored except as the name of a register or to 
terminate a number. 

If a file name is given, input is taken from that 
file until end-of-file, then input is taken from 
the console. 

An example to calculate the monthly, weekly and 
hourly rates for a $10,000/year salary. 

10000 

100* (now in cents) 
dsa (non-destructive store) 
12/ (pennies per month) 

la52/ (pennies per week) 
dIO* (deci-pennies per week) 
375/ (pennies per hour) 
f (print all results) 

512 

19230 
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83333 
"a" 1000000 

An example which prints the first ten values of nl is 
[Ia1+dsa*plai0>x] sx 
Osa1 
Ixx 

FILES 

SEE ALSO msh(VIl), salloc(lll) 

DIAGNOSTICS (x) ? for unrecognized character x. 

(x) ? for not enough elements on the stack to do 
what was asked by command x, 

"out of space" when the free list is exhausted 
j^too many digits). 

Out of headers" for too many numbers being kept 
around. 

"out of pushdown" for too many items on the 
stack, 

"Nesting Depth" for too many levels of nested 
execution, 

BUGS — 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



df — disk free 
df [ filesystem ] 

df prints out the number of free blocks available 
on a file system. If the file system is unspeci- 
fied, the free space on all of the normally 
mounted file systems is printed. 

/dev/rf?, /dev/rk?, /dev/rp? 

check{VIIl) 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



dsw — delete interactively 
dsw [ directory ] 

For each file in the given directory i"." if not 
specified) dsw types its _ name. If y is typed, 



the file is deleted; if 



dsw exits; if any- 



thing else, the file is not removed, 



rm(l) 



The name dsw is a carryover from the ancient 
past* Its etymology is amusing but the name is 
nonetheless ill-advised. 
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NAME 

SYNOPSIS 

DESCRIPTION 



du — summarize disk usage 

du [z:s][^][ name ... ] 

du gives the number of blocks contained in all 
files and (recursively) directories within each 
specified directory or file name. If name is 
missing, ^ is used* 

The optional argument ^ causes only the grand 
total to be given. The optional argument ^ 
causes an entry to be generated for each file. 
Absence of either causes an entry to be generated 
for each directory only. 

A file which has two links to it is only counted 
once. 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



Non-directories given as arguments (not under -a 
option) are not listed. 

Removable file systems do not work correctly 
since i-numbers may be repeated while the 
corresponding files are distinct. Du should 
maintain an i-number list per root directory 
encountered . 
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NAME 

SYNOPSIS 

DESCRIPTION 



echo 



echo arguments 



echo [ arg^ ... ] 

echo writes all its arguments in order as a line 
on the standard output file. It is mainly useful 
for producing diagnostics in command files. 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 
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NAME 

ed — editor 

SYNOPSIS 

ed [ name ] 

DESCRIPTION 

ed is the standard text editor. 

If the optional argument is given, ed simulates an e com- 
mand on the named file; that is to say, the file is read 
into ed's buffer so that it can be edited. 

ed operates on a copy of any file it is editing; changes 
made in the copy have no effect on the file until a write 
(w) command is given. The copy of the text being edited 
resides in a temporary file called the buffer . There is 
only one buffer. 

Commands to ed have a simple and regular structure: zero 
or more addresses followed by a single character command , 
possibly followed by parameters to the command. These 
addresses specify one or more lines in the buffer. Every 
command which requires addresses has default addresses, 
so that the addresses can often be omitted. 

In general, only one command may appear on a line. Cer- 
tain commands allow the input of text. This text is 
placed in the appropriate place in the buffer. While ed 
is accepting text, it is said to be in input mode , in 
this mode, no commands are recognized; all input is mere- 
ly collected. Input mode is left by typing a period (.) 
alone at the beginning of a line. 

ed supports a limited form of regular expression nota- 
tion. A regular expression is an expression which speci- 
fies a set of strings of characters. A member of this 
set of strings is said to be matched by the regular ex- 
pression. The regular expressions allowed by ed are con- 
structed as follows: 

1 . An ordinary character (not one of those discussed 
below) is a regular expression and matches that 
character. 

2. A circumflex at the beginning of a regular 
expression matches the null character at the begin- 
ning of a line . 

3. A currency symbol ($) at the end of a regular ex- 
pression matches the null character at the end of a 
line . 

4. A period ( . ) matches any character but a new-line 
character. 
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5. A regular expression followed by an asterisk (*) 
matches any number of adjacent occurrences (includ- 
ing zero) of the regular expression it follows. 

6. A string of characters enclosed in square brackets 
( [] ) matches any character in the string but no 
others. If, however, the first character of the 
string is a circumflex C) the regular expression 
matches any character but new-line and the charac- 
ters in the string. 

7. The concatenation of regular expressions is a regu- 
lar expression which matches the concatenation of 
the strings matched by the components of the regu- 
lar expression. 

8. The null regular expression standing alone is 
equivalent to the last regular expression encoun- 
tered. 

Regular expressions are used in addresses to specify 
lines and in one command (s, see below) to specify a por- 
tion of a line which is to be replaced. 

If it is desired to Use one of the regular expression 
metacharacters as an ordinary character, that character 
may be preceded by "X". This also applies to^the charac- 
ter bounding the regular expression (often "/") and to 
"\" itself. 

Addresses are constructed as follows. To understand 
addressing in ed it is necessary to know that at any time 
there is a current line . Generally speaking, the current 
line is the last line affected by a command; however, the 
exact effect on the current line by each command is dis- 
cussed under the description of the command. 

1 . The character addresses the current line. 

2. The character addresses the line immediately 
before the current line. 

3. The character addresses the last line of the 
buffer. 

4. A decimal number n addresses the nth line of the 
buffer. ~ 

6. A regular expression enclosed in slashes "/" ad- 
dresses the first line found by searching toward 
the end of the buffer and stopping at the first 
line containing a string matching the regular ex- 
pression. If necessary the search wraps around to 
the beginning of the buffer. 

5. A regular expression enclosed in queries 
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addresses the first line found by searching toward 
the beginning of the buffer and stopping at the 
first line found containing a string matching the 
regular expression. If necessary the search wraps 
around to the end of the buffer* 

7. An address followed by a plus sign or a minus 
sign followed by a decimal number specifies 
that address plus (resp* minus) the indicated 
number of lines • The plus sign may be omitted* 

8. "'x" addresses the line associated (marked) with 
the mark name character "x" which must be a print- 
able character. Lines may be marked with the "k" 
command described below. 

Commands may require zero, one, or two addresses. Com- 
mands which require no addresses regard the presence of 
an address as an error. Commands which accept one or two 
addresses assume default addresses when insufficient are 
given. If more addresses are given than such a command 
requires, the last one or two (depending on what is ac- 
cepted) are used. 

Addresses are separated from each other typically by a 
comma (,). They may also be separated^by a semicolon 
(;). In this case the current line is set to the 
previous address before the next address is interpreted. 
This feature can be used to determine^ the starting line 
for forward and backward searches ("/", "?"). The second 
address of any two-address sequence must correspond to a 
line following the line corresponding to the first ad- 
dress. 

In the following list of ed commands, the default ad- 
dresses are shown in parentheses. The parentheses are 
not part of the address, but are used to show that the 
given addresses are the default. 

As mentioned, it is generally illegal for more than one 
command to appear on a line^ However, any command may be 
suffixed by p" (for "print ). In that case, the current 
line is printed after the command is complete. 

(.)a 

<text> 

. 

The append command reads the given text and appends 
it after the addressed line. is left on the 

last line input, if there were any, otherwise at 
the addressed line. Address "o" is legal for this 
command; text is placed at the beginning of the 
buffer. 

(•,.)c 

<text> 
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The change command deletes the addressed lines, 
then accepts input text which replaces these lines, 
"•"is left at the last line input; if there were 
none, it is left at the first line not changed, 

(.,*)d 

The delete command deletes the addressed lines from 
the buffer. The line originally after the last 
line deleted becomes the current line; if the lines 
deleted were originally at the end, the new last 
line becomes the current line. 

e filename 

The edit command causes the entire contents of the 
buffer to be deleted, and then the named file to be 
read in. is set to the last line of the 

buffer. The number of characters read is typed, 
"filename** is remembered for possible use as a 
default file name in a subsequent r or w command. 

f filename 

The filename command jgrints the currently remem- 
bered file name. If filename" is given, the 
currently remembered file name is changed to 
"filename**. 

(1 ,$)g/regular expression/command list 

In the £lobal command, the first step is to mark 
every line which matches the given regular expres- 
sion. Then for every such line, the given command 
list is executed with "." initially set to that 
line. A single command or the first of multiple 
commands appears on the same line with the global 
command. All lines of a mult^-JLine list except the 
last line must be ended with \ • a* if and c-com- 
mands and associated input are permitted; the "." 
terminating input mode may be omitted if it would 
be on the last line of the command list. The (glo- 
bal) commands, 3 and v, are not permitted in the 
command list. 

(.)i 

<text> 

. 

This command inserts the given text before the 
addressed line. "." is left at the last line 
input; if there were none, at the addressed line. 
This command differs from the a command only in the 
placement of the text. 

(.)kx 

The mark command associates or marks the ^dgressed 
line with the single character mark name x . The 
ten most recent mark names are remembered. The 
current mark names may be printed with the n 
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command. 
( . , • )mA 

The move command will reposition the addressed 
lines after the line addressed by "a". The line 
originally after the last line moved becomes the 
current line; if the lines moved were originally at 
the end, the new last line becomes the current 
line . 

n 

The marknames command will print the current mark 
names* 

(•,.)p 

The £rint command prints the addressed lines. 
is left at the last line printed* The £ command 
may be placed on the same line after any command. 

2 

The auit command causes ed to exit. No automatic 
write of a file is done. 

($)r filename 

The read command reads in the given file after the 
addressed line. If no file name is given, the 
remembered file name, if any^ is used (see e and f 
commands). The remembered file name is not changed 
unless "filename"^ is the very first file name men- 
tioned. Address "o** is legal for r and causes the 
file to be read at the beginning of the buffer. If 
the read is succesgful, the number of characters 
read is typed. is left at the last line read 

in from the file. 

( . , . )s/regular expression/replacement/ or, 

( . , . ) s/regular expre ssion/replacement/g 

The substitute command searches each addressed line 
for an occurrence of the specified regular expres- 
sion. On each line in which a match is found, all 
matched strings are replaced by the replacement^ 
specified, if the global replacement indicator g" 
appears after the command. If the global indicator 
does not appear, only the first occurrence of the 
matched string is replaced. It is an error for the 
substitution to fail on all addressed lines. Any 
character o^her than space or new-line may be used 
instead of /" to delimit the regular expression 
and the replacement. is left at the last line 

substituted. 

The ampersand appearing in the replacement is 
replaced by the regular es^ression Jhat was 
matched. The special meaning of "& in this^ con- 
text may be suppressed by preceding it by "X". 
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( 1 t$ )v/regular expression/command list 

This command is the same as the global command 
except that the command list is executed with 
initially set to every line except those matching 
the regular expression 

(1 ,$ )w filename 

The write command writes the addressed lines onto 
the given file. If the file does not exist, it is 
created mode 17 (readable and writeable by every- 
one). The remembered file name is not changed 
unless "filename** is the very first file name men- 
tioned. If no file name is given, the remembered 
file name, if any, is used (see e and f commands). 

is unchanged. If the command is successful, 
the number of characters written is typed. 

($) = 

The line number of the addressed line is typed, 
is unchanged by this command. 

lUNIX command 

The remainder of the line after the "l" is sent to 
UNIX to be interpreted as a command. is un- 

changed . 

( .+1 )<newline> 

An address alone on a line causes that line to be 
printed. A blank line alone is equivalent to 
. + 1p''; it is useful for stepping through text. 

If an interrupt signal (ASCII DEL) is sent, ed will print 
a and return to its command level. 

If invoked with the command name (see init ) ed will 

sign on with the message "Editing system" and print "♦" 
as the command level prompt character. 

Ed has size limitations on the maximum number of lines 
that can be edited, and on the maximum number of charac- 
ters in a line, in a global' s command list, and in a 
remembered file name. These limitations vary with the 
physical core size of the PDP11 computer on which ed is 
being used. The range of limiting sizes for the above 
mentioned items is; 1300 - 4000 lines per file, 256 - 512 
characters per line, 63 - 256 characters per global com- 
mand list, and 64 characters per file name« 

FILES 

/tmp/etm? temporary 

/etc/msh to implement the "l" command. 

SEE ALSO 

DIAGNOSTICS "?" for any error 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



exit — terminate command file 
exit 

exit performs a seek to the end of its standard 
input file. Thus, if it is invoiced inside a file 
of commands, upon return from exit the shell will 
discover an end-of-file and terminate. 



if(l), goto(l), sh(l) 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



factor 
factor 



discover prime factors of a number 



When factor is invoked, it types out Enter: at 
you. If you type in a positive number less than 
2*^56 (about 7,2E16), it will repeat the number 
back at you and then its prime factors each one 
^rinted^the proper number of times. Then it says 

Enter:** again. To exit, feed it an EOT or a 
delete. 

Maximum time to factor is proportional to sqrt(n) 
and occurs when n is prime. It takes 1 minute to 
factor a prime near 10*^1 3. 



Ouch, 
input. 



for input out of range or for garbage 



BUGS 
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NAME fc — fortran compiler 

SYNOPSIS fc [ ::;c ] sfile^j^ ... ofile^ ... 

DESCRIPTION fc is the UNIX Fortran Compiler. It accepts 

three types of arguments: 

Arguments whose names end with "•f" are assumed 
to be Fortran source program units; they are com- 
piled, and the object program is left on the file 
sf ile. .o (i.e. the^file whose name is that of 
the source with ".o" substituted for ".f"). 

Other arguments (except for "-c") are assumed to 
be either loader flags, or object programs, typi- 
cally produced ty an earlier fc run, or perhaps 
libraries of Fortran-compatible routines* These 
programs, together with the results of any compi- 
lations specified, are loaded (in the order 
given) to produce an executable program with name 
a. out . 

The "-c** argument suppresses the loading phase, 
as does any syntax error in any of the routines 
being compiled. 

The following is a list of differences between fc 
and ANSI standard Fortran (also see the BUGS 
section) : 

1 • Arbitrary combination of types is allowed in 
expressions. Not all combinations are expect- 
ed to be supported at runtime. All of the 
normal conversions involving integer, real, 
double precision and complex are allowed. 

2. The 'standard' implicit statement is recog- 
nized. 

3. The types doublecomplex, logical*1 , integer*2 
and realms (doubleprecision) are supported. 

4. & as the first character of a line signals a 
continuation card. 

5. c as the first character of a line signals a 
comment. 

6. All keywords are recognized in lower case. 

7. The notion of 'column 7* is not implemented. 

8. G-format input is free form— leading blanks 
are ignored, the first blank after the start 
of the number terminates the field. 
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9, A comma in any numeric or logical input field 
terminates the field. 

10. There is no carriage control on output. 

In I/O statements, only unit numbers 0-19 are 
supported. Unit number nn corresponds^^ to file 
**fortnn; " (e.g. unit 9 is file '*fort09**). For 
input, the file must exist; for output, it will 
be created. 

Unit 5 is permanently associated with the stan- 
dard input file; unit 6 with the standard output 
file. 



FILES file.f input file 

a. out loaded output 

f.tmp[l23] temporary (deleted) 

/usr/fort/fc [1 234] compilation phases 

/usr/lib/frO.o runtime startoff 

/usr/lib/f ilib.a interpreter library 

/usr/lib/libf .a builtin functions, etc. 

/usr/lib/liba.a system library 

SEE ALSO ANSI standard 

DIAGNOSTICS Compile-time diagnostics are given by number. If 

the source code is available, it is printed with 
an underline at the current character pointer. 
Errors possible are; 



1 


statement too long 




2 


syntax error in type statement 




3 


redeclaration 




4 


missing ( in array declarator 




5 


syntax error in dimension statement 


6 


inappropriate or gratuitous array 


de- 




clarator 




7 


syntax error in subscript bound 




8 


illegal character 




9 


common variable is a parameter or 


al ready 




in common 




10 


common syntax error 




11 


subroutine/blockdata/f unction not 


first 




statement 




12 


subroutine/function syntax error 




13 


block data syntax error 




14 


redeclaration in external 




15 


external syntax error 




16 


implicit syntax error 




17 


subscript on non-array 




18 


incorrect subscript count 




19 


subscript out of range 




20 


subscript syntax error 




21 


DATA syntax error 




22 


DATA semantics error 




23 


Illegal variable in DATA 
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23 


equivalence inconsistency 


24 


equivalence syntax error 


25 


separate common blocks equivalenced 


26 


common block illegally extended by 




equivalence 


27 


common inconsistency created by 




equivalence 


28 


DATA table overflow 


29 


imbalance in expression 


30 


expression syntax error 


31 


illegal variable in equivalence 


32 


Storage initialized twice by DATA 


33 


non array/function used with 




subscripts /arguments 


35 


goto syntax error 


37 


illegal return 


38 


continue, return, stop, call, end, or 




pause syntax error 


39 


assign syntax error 


40 


if syntax error 


41 


l/O syntax error 


42 


do or l/o iteration error 


43 


do end missing 


50 


illegal statement in block data 


51 


multiply defined labels 


52 


undefined label 


53 


dimension mismatch 


34 


expression syntax error 


55 


end of statement in hollerith constant 


DO 


array t^oo j.arge 


99 


^ table overflow 


101 


unrecognized statement 


Runtime 


diagnostics: 


1 


invalid log argument 


2 


bad arg count to amod 


3 


bad arg count to atan2 


4 


excessive argument to cabs 


5 


exp too large in cexp 


6 


bad arg count to cmplx 


7 


bad arg count to dim 


8 


excessive argument to exp 


9 


bad arg count to idim 


10 


bad arg count to isign 


11 


bad arg count to mod 


1 2 


bad arg count to sign 


13 


illegal argument to sqrt 


14 


assigned/computed goto out of range 


15 


subscript out of range 


16 


real»*real overflow 


100 


illegal I/O unit number 


101 


inconsistent use of l/o unit 


102 


cannot create output file 


103 


cannot open input file 
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104 EOF on input file 

105 illegal character in format 

106 format does not begin with ( 

107 no conversion in format but non-empty 
list 

108 excessive parenthesis depth in format 

109 illegal format specification 

110 illegal character in input field 

111 end of format in hollerith specification 
999 unimplemented input conversion 

The following is a list of those features not yet 
implemented : 

arithmetic statement functions 
backspace, endfile, rewind runtime 
binary I/O 

no scale factors on input 
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NAME 

fed — edit associative memory for form letter 

SYNOPSIS 

fed 

DESCRIPTION 

fed is used to edit a form letter associative 
memory file, form.m, which consists of named 
strings. Commands consist of single letters fol- 
lowed by a list of string names separated by a 
single space and ending with a new line. The 
conventions of the Shell with respect to and 

hold for all commands but m where literal 
string names are expected. The commands are; 

e name^ » » . 

edit writes the string whose name is name, 
onto a temporary file and executes the sys- 
tem editor ed. On exit from the system edi- 
tor the temporary file is copied back into 
the associative memory. Each argument is 
operated on separately. The sequence of 
commands to add the string from 'file' to 
memory with name 'newname' is as follows: 

e newname 

(printed by ed) 

r file 

200 

w 

200 

q (get out of ed) 

q (get out of fe) 

To dump a string onto a file: 

e name 

200 (printed by ed) 

w filename 

200 

q (get out of ed) 

q (get out of fe) 



d [ name^ ..• ] 

deletes a string and its name from the 
memory. When called with no arguments d 
operates in a verbose mode typing each ~" 
string name and deleting only if a 'y' is 
typed. A *q' response returns to fed's com- 
mand level. Any other response does noth- 
ing. 
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m name^ namej • • • 

(move ) changes the name of name to name^ 
and removes previous string name^ if one 
exists. Several pairs of arguments may be 
given. 



n [ name^ ... ] 

(names) lists the string names in the 
memory. If called with the optional argu 
ments, it just lists those requested. 



p name^ 



... 



prints the contents of the strings with 
names given by the arguments. 



q (auit) returns to the system. 



c [ E ] [ f ] 

checks the associative memory file for con- 
sistency and reports the number of free 
headers and blocks. The optional arguments 
do the following: 

p causes any unaccounted for string to be 
printed 

f fixes broken memories by adding 

unaccounted-for headers to free storage 
and removing references to released 
headers from associative memory. 



FILES /trop/ftmp? temporary 

form.ro associative memory 

SEE ALSO forro(l), ed(l), sh(l) 

DIAGNOSTICS unknown command 

'Cannot open temp, file' — cannot create a tem- 
porary file for ed command 

'name not in memory.' if string 'name' is not in 
the associative memory and is used as an argument 
for d or m. 

BUGS 

WARNING It is legal but an unwise idea to have string 

names with blanks, or in them. 
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NAME 

form — form letter generator 

SYNOPSIS 

form proto arg^ ... 

DESCRIPTION 

form generates a form letter from a prototype 
letter, an associative memory, arguments and in a 
special case, the current date. 

If form is invoked with the proto argument 'x', 
the associative memory is searched for an entry 
with name 'x' and the contents filed under that 
name are used as the prototype. If the search 
fails, the message "[x]:** is typed on the console 
and whatever text is typed in from the console, 
terminated by two new lines, is used as the pro- 
totype • 

If the prototype argument is missing, '{letter}' 
is assumed. 

Basically, form is a copy process from the proto- 
type to the output file. If an element of the 
form [n] (where n is a digit from 1 to 9) is 
encountered, the"'nth argument arg is inserted in 
its place, and that argximent is tfien rescanned. 
If [0] is encountered, the current date is in- 
serted. If the desired argument has not been 
given, a message of the form "[n] is typed. 
The response typed in then is used for that argu- 
ment. 

If an element of the form [name] or {name} is 
encountered, the name is looked up in the associ- 
ative memory. If it is found, the contents of 
the memory under this name replaces the original 
element (again rescanned). If the name is not 
found, a message of the form "[name]:" is typed. 
The response typed in is used for that element. 
The response is entered in the memory under the 
name if the name is ienclosed in [] . The response 
is not entered in the memory but is remembered 
for the duration of the letter if the name is 
enclosed in {}. 

In both of the above cases, the response is typed 
in by entering arbitrary text terminated by two 
new lines. Only the first of the two new lines 
is passed with the text. 

If one of the special characters [{] }\ is preced- 
ed by a \, it loses its special character. 

If a file named "forma" already exists in the 
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FILES 

SEE ALSO 
DIAGNOSTICS 

BUGS 



users directory, formb is^used as the output 
file and so forth to "formz". 

The file "form.m*' is created if none exists. 
Because form.m is operated on by the disc alio- 
cater, it should only be changed by using fed, 
the form letter editor, or form . 



form.m associative memory 
form? output file (read only) 



fed(l), type (I), roff(l) 

"cannot open output file" "cannot open memory 
file" when the appropriate files cannot be locat- 
ed or created. 



An unbalanced ] or } acts as an end of file "tut 
may add a few strange entries to the associative 
memory . 
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SYNOPSIS 
DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



forml [ name ] • • • 

A streamlined program for typing form letters. 
The names pick out pre stored form letters 
prepared according to the conventions of form and 
roff . The program prompts to get each blank 
filled in. When all the forms are completed, it 
prompts "set paper." It waits for a newline be- 
fore printing each letter. 

If more than one name is given, the name of each 
letter is announced before the prompts for it 
begin. If no names are given, the program asks 
"which letter?" before each. Respond with the 
name and a newline, or newline only when done. 

On a 2741 type terminal, the program assumes the 
letter is to be t^ped with a correspondence ball, 
and also prompts Change ball." Replace the ball 
at the end. 

form.ro (memory), 

forma, formb, ... temporaries 

form(l), fed(l), roff(l) 

"Try again" — can't get a process 
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NAME 

SYNOPSIS 

DESCRIPTION 



goto — command transfer 
goto label 

goto is only allowed when the Shell is taking 
commands from a file. The file is searched^! from 
the beginning) for a line beginning with fol- 
lowed by one or more spaces followed by the 
label . If such a line is found, the goto command 
returns. Since the read pointer in the command 
file points to the line after the label, the 
effect is to cause the Shell to transfer to the 
labelled line. 

is a do-nothing command that only serves to 
place a label. 



FILES 

SEE ALSO 

DIAGNOSTICS 



sh(l), :(I) 

][goto error", if the input file is a typewriter; 
"label not found". 



BUGS 
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NAME 

SYNOPSIS 

DESCRIPTION 



hyphen — find hyphenated words 
hyphen file^ ... 

It finds all of the words in a document which are 
hyphenated across lines and prints them back at 
you in a convenient format. 

If no arguments are given, the standard input is 
used. Thus hyphen may be used as a filter. 



FILES 
SEE ALSO 

DIAGNOSTICS yes 

BUGS yes, it gets confused, but with no ill effects 

other than spurious extra output. 
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NAME 

SYNOPSIS 

DESCRIPTION 



if — conditional command 
if expr command [ arg^ ... ] 

if evaluates the expression expr > and if its 
value is true , executes the given command with 
the given arguments. 

The following primitives are used to construct 
the expr t 

=r file 

true if the file exists and is readable, 
^ file 

true if the file exists and is writable 
s1 = s2 

true if the strings sj^ and s2 are equal. 
s1 J= s2 

true if the strings sj, and s2 are not 
equal. 

These primaries may be combined with the follow- 
ing operators: 



! 



-a 



-o 



unary negation operator 



binary and operator 



binary or operator 



i expr X 

parentheses for grouping. 

-a has higher precedence than Notice that 

all the operators and flags are separate argu- 
ments to if and hence must be surrounded by 
spaces. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



sh(l) 

"if error", if the e3q>ression has the wrong 
syntax; "command not found." 



1 - 



LD (I) 3/15/72 LD (l) 

NAME Id — link editor 



Id [ -sulxr ] name^ ... 

Id combines several object programs into one; 
resolves external references; and searches li- 
braries. In the simplest case the names of 
several object programs are given, and Id com- 
bines them, producing an object module which can 
be either executed or become the input for a 
further Id run. In the latter case, the "-r" 
option must be given to preserve the relocation 
bits . 

The argtiment routines are concatenated in the 
order specified. The entry point of the output 
is the beginning of the first routine. 

If any argument is a library, it is searched 
exactly once. Only those routines defining an 
unresolved external reference are loaded. If a 
routine from a library references another routine 
in the library, the referenced routine must ap- 
pear after the referencing routine in the li- 
brary. Thus the order of programs within li- 
braries is important. 

Id understands several^ flag arguments which are 
written preceded by a : 

-s "squash" the output, that is, remove the 
symbol table and relocation bits to save 
space (but impair the usefulness of the 
debugger) . This information can also be 
removed by strip . 

-u take the following argument as a symbol and 
enter it as undefined in the symbol table. 
This is useful for loading wholly from a 
library, since initially the symbol table 
is empty and an unresolved reference is 
needed to force the loading of the first 
routine. 

-1 This option is an abbreviation for a li- 
brary name, "-l" alone stands for 
"/usr/lib/liba.a", which is the standard 
system library for assembly language pro- 
grams. "-Ix" stands for "/usr/lib/libx.a" 
where x is any character. There are^li- 
braries for Fortran (xs^f''^* C (xs^c"), 
Explor (xs^e") and B (xs^b ). 

-X Do not preserve local (non-.globl) symbols 
in the output symbol table; only enter 
external symbols. This option saves some 



SYNOPSIS 
DESCRIPTION 
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space in the output file, 

-r generate relocation bits in the output file 
so that it can be the subject of another Id 
run. 

The output of Id is left on a .out . This file is 
executable only if no errors occurred during the 
load. 

FILES /usr/lib/lib?.a libraries 

a. out output file 

SEE ALSO as(l) , ar(l) 

DIAGNOSTICS "file not found" — bad argument 

"bad format" — bad argument 

"relocation error" — bad argument (relocation 
bits corrupted) 

"multiply defined" — same symbol defined twice in 
same load 

"un" — stands for "undefined symbol" 

"symbol not found"— loader bug 

"can't move output file" — can't move temporary 
to a. out file 

"no relocation bits" — an input file lacks relo- 
cation information 

"too many symbols" — too many references to 
external symbols in a given routine 

"premature EOf" 

"can't create l.out" — cannot make temporary file 

"multiple entry point"— more than one entry 
point specified (not possible yet). 

BUGS 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



In — make a link 
In name^ [ name^ ] 

In creates a link to an existing file name. , if 
name, is given, the link has that name; otherwise 
it is placed in the current directory and its 
name is the last component of name^ , 

It is forbidden to link to a directory or to link 
across file systems* 



rm(l) 



There is nothing particularly wrong with In, but 
links don't work right with respect to the backup 
system: one copy is backed up for each link, and 
(more serious) in case of a file system reload 
both copies are restored and the information that 
a link was involved is lost. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 
DIAGNOSTICS 



login — sign onto UNIX 

login [ usernaroe [ password ] ] 

The locfin conunand is used when a user initially 
signs onto UNIX, or it may be used at any time to 
change from one user to another. The latter case 
is the one summarized alxjve and described here. 
See *'how to Get Started" (p. vi) for how to dial 
up initially. 

loQin is invoked without an argument, it will 
ask for a user name, and, if appropriate, a pass- 
word. Echoing is turned off (if possible) during 
the typing of the password, so it will not appear 
on the written record of the session. 

After a successful login, accounting files are 
updated and the user is informed of the existence 
of mailbox and message-of-the-day files. 

Login is recognized by the Shell and executed 
directly (without forking). 



/tmp/utmp 

/tmp/wtmp 

mailbox 

/etc/motd 

/etc/passwd 



accounting 
accounting 
mail 

message-of-the-day 
password file 



init(VIl), getty(VIl), mail(l) 

"login incorrect", if the name or the password^is 
bad. "no Shell,", "cannot open password file," 
"no directory:" consult a UNIX programming coun- 
cilor. 



BUGS 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



Is — list contents of directory 
Is [ "-Itasd ] name^ 

Is lists the contents of one or more directories 
under control of several options : 

-1 list in long format, giving i-number, mode, 
owner, size in bytes, and time of last 
modification for each file, (see stat for 
format of the mode) 

-t sort by time modified (latest first) instead 
of by name, as is normal 

->a list all entries; usually those beginning 
with are suppressed 

-s give size in blocks for each entry 

-d if argument is a directory, list only its 
name, not its contents (mostly used with 
"-l" to get status on directory) 

If no argument is given, is listed. If an 

argument is not a directory, its name is given. 

/etc/passwd to get user ID's for Is -1 

stat(l) 

"name none xj stent"; "name unreadable"; "name 
unstatable . 
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NAME m6 — general purpose macro processor 

SYNOPSIS m6 [ ::d arg1 ] [ arg2 [ arg3 ] J 

DESCRIPTION m6 takes input from file arg2 (or standard input 

if arg2 is missing) and places output on file 
arg3 (or standard output). A working file of 
definitions, "m.def", is initialized from file 
argi if that is supplied. M6 differs from the 
standard [1] in these respects; 

#trace:, ^source: and #end: are not defined. 

#meta,arg1 ,arg2 : transfers the role of metachar- 
acter argi to character arg2. If two metacharac- 
ters become identical thereby, the outcome of 
further processing is not guaranteed. For exam- 
ple, to make [] { } play the roles of # :<> type 

\#meta,<\#>, [: 
[meta,<:>,] : 

[meta, [substr,«»,1 ,1 ; , {] 
[meta, [substr, { {», 2, 1 ; ,}] 

#del,arg1 : deletes the definition of macro argi. 

#save: and #rest; save and restore the definition 
table together with the current metacharacters on 
file m.def . 

#def ,arg1 ,arg2,arg3 ! works as in the standard 
with the extension that an integer may be sup- 
plied to argS to cause the new macro to perform 
the action of a specified builtin before its 
replacement text is evaluated. Thus all built ins 
except #def ! can be retrieved even after dele- 
tion. Codes for arg3 are: 

- no function 

1,2,3,4,5,6 - gt,eq,ge,lt,ne,le 
7,8 - seq,sne 

9,10,11,12,13 - add,sub,mpy,div,exp 
20 - if 

21 ,22 - def ,copy 

23 - meta 

24 - size 

25 - substr 
26,27 - go,gobk 

28 - del 

29 - dnl 

30,31 - save, rest 

FILES m.def — working file of definitions 

/usr/lang/mdir/m6a — m6 processor proper 
(/usr/bin/m6 is only an initializer) 
/usr/lang/mdir/m6b — default initialization for 
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m.def 

/bin/cp — used for copying initial value of m.def 

[1] A. D. Hall, The M6 Macroprocessor , Bell Tele 
phone Laboratories, 1969 

"err" — a bug, an unknown builtin or a bad de- 
finition table 

^oprd" — can't open input or initial definitions 

^opwr" — can^t open output 

^ova" — overflow of nested arguments 

"ovc" — overflow of calls 

[[ovd** — overflow of definitions 

Try again" — no process available for copying 
m.def 

Characters in internal tables are stored one per 
word. They really should be packed to improve 
capacity. For want of space (and because of 
unpacked formats) no file arguments have been 
provided to #save: or #rest:, and no check is 
made on the actual opening of file m.def. Again 
to save space, garbage collection makes calls on 
#save: and #rest; and so overwrites m.def. 
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NAME 
SYNOPSIS 

DESCRIPTION 



mall — send mail to another user 

mail [ -vn ] 

mail letter person 

mail person 

mail without an argument searches for a file 
called mailbox , prints it if present, and asks if 
it should be saved. If the answer is y", the 
mail is renamed mbox . otherwise it is deleted. 
Mail with a -vn argument works the same way, 
except that the answer to the question is sup- 
plied by the argument. 

When followed by the names of a letter and one or 
more people, the letter is appended to each 
person's mailbox . When a person is specified 
without a letter , the letter is taken from the 
sender's standard input up to an EOT. Each 
letter is preceded by the sender's name and a 
postmark. 

A person is either a user name recognized by 
login , in which case the mail is sent to the 
default working directory of that user, or the 
path name of a directory, in which case mailbox 
in that directory is used. 

When a user logs in he is informed of the pres- 
ence of mail. 



FILES 



SEE ALSO 
DIAGNOSTICS 



/etc/pa sswd 

mailbox 
mbox 

login(l) 



to identify sender 
to locate persons 
input mail 
saved mail 



Who are you? if the user^cannot be identified 
for some reason (a bug) , "cannot send to user" 
mailbox cannot be opened. 



BUGS 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



man — run off section of UNIX manual 
man title [ section ] 

man is a shell command file that will locate and 
run off a particular section of this manual. 
Title is the the desired part of the manual. 
Section is the section number of the manual. (in 
Arabic, not Roman numerals.) If section is miss- 
ing, 1, is assumed. For example, 

man man 

would reproduce this page. 

/sys/man/man?/* 

sh(l), roff(l) 



File not found 



Usage 



1 - 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



mesg — permit or deny messages 
mesq [ n ] [ ^ ] 

mesg n forbids messages via write by revoking 
non-user write permission on the user's typewrit- 
er, mesg x reinstates permission, mesg with no 
argument reverses the current permission, in all 
cases the previous state is reported. 

/dev/tty? 

write (I) 



er 



if the standard input file is not a typewrit- 



BUGS 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



mkdir — make a directory 
mkdlr dirname • • • 

mkdir creates specified directories in mode 17. 



The standard entries • 
tomatically. 



rmdir(l) 
"dirname ?' 



and 



are made au- 
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NAME mt — manipulate magtape 

SYNOPSIS mt [ key ] [ name •.. ] 

DESCRIPTION mt saves and restores selected portions of the 

file system hierarchy on magtape. Its actions 
are controlled by the key argument. The key is a 
string of characters containing at most one func- 
tion letter and possibly one or more function 
modifiers. Other arguments to the command are 
file or directory names specifying which files 
are to be dumped, restored, or tabled. 

The function portion of the key is specified by 
one of the following letters: 

r The indicated files and directories, to- 
gether with all subdirectories, are dumped 
onto the tape. The old contents of the 
tape are lost. 

X extracts the named files from the tape to 
the file system. The owner, mode, and 
date-modified are restored to what they 
were when the file was dumped. If no file 
argument is given, the entire contents of 
the tape are extracted. 

t lists the names of all files stored on the 
tape which are the same as or are hierarch- 
ically below the file arguments. If no 
file argument is given, the entire contents 
of the tape are tabled. 

1 is the same as t except that an expanded 
listing is produced giving all the avail- 
able information about the listed files. 

The following characters may be used in addition 
to the letter which selects the function desired. 

0, 7 This modifier selects the drive on 

which the tape is mounted, "o" is the 
default. 

V Normally mt does its work silently. The v 
(verbose) option causes it to type the name 
of each file it treats preceded by a letter 
to indicate what is happening. 

a file is being added 

X file is being extracted 

The V option can be used with r and x only, 
f causes new entries copied on tape to be 
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'fake' in that only the entries, not the 
data associated with the entries are updat- 
. ed. Such fake entries cannot be extracted. 
Usable only with r. 

w causes mt to pause before treating each 
file, type the indicative letter and the 
file name (as with and awaij th^ user's 
response. Response^ y" means yes , so the 
file is treated. Null response means **no*', 
and the file does not take ^art in whatever 
is being done. Response "x means "exit"; 
the mt command terminates immediately. In 
the x function, files previously asked 
about have been extracted already. With r, 
no change has been made to the tape. 

m make (create) directories during an x if 
necessary . 

FILES /dev/mt? 

SEE ALSO tap(l), tap(v) 

DIAGNOSTICS Tape open error 

Tape read error 
Tape write error 
Directory checksum 
Directory overflow 
Seek error 
Tape overflow 

Phase error (a file has changed after it was 
selected for dumping but before it was dumped) 

BUGS If, during an "x", the files are specified in a 

different order than they are on the tape, seek 
errors will result because the tape cannot be 
rewound. 
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NAME 

SYNOPSIS 

DESCRIPTION 



mv — move or rename a file 
my name^ namej 

mv changes the name of name, to name^ . if name^ 
is a directory, name, is moved to that directory 
with its original file-name. Directories may 
only be moved within the same parent directory 
(just renamed). 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



yes 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



nm — print name list 
nm [ name ] 

run prints the symbol table from the output file 
of an assembler or loader run* Each symbol name 
is preceded by its value blanks if undefined) 
and one of the letters "u (undefined) "a" (abso- 
lute) "t** (text segment symbol), "d" (data seg- 
ment symbol), or "b" (bss segment symbol ) • Glo- 
bal symbols have their first character under- 
lined. The output is sorted alphabetically. 

If no file is given, the symbols in a .out are 
listed. 

a .out 

as(l), ld(l) 
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REQUEST REFERENCE AND INDEX 

If no Cause 

Argument Br eak Explanation 



Request Initial 

Form Value 

!• Page Control 

.pi +N N=66 

.bp +N N=1 

.pn +N N=1 

.po +N N=0 

.ne N - 



N=66 no 

- yes 

ignor ed no 

N=pr ev no 

N=1 no 



Page Length. 
Begin Page, 
Page Number. 
Page Offset. 
NEed N lines. 



Text Filling . Ad lusting , and Cent er ing 



.br 






yes 


BReak. 


.f i 


fill 




yes 


Fill output lines. 


.nf 


fill 




yes 


NoFill. 


.ad c 


ad j, norm 


ad just 


no 


ADjust mode on. 


.na 


adjust 




no 


No Ad just. 


.ce N 


off 


N=1 


yes 


CEnter N input text lines. 



III. Line Sp ac ing and Blank Lines 



.Is +N N=1 


N=prev 


no 


Line Spacing. 


.sp N 


N=1 


yes 


SPace N lines 


.Iv N 


N=1 


no 


OR- 


.sv N 


N=1 


no 


SaVe N lines. 


.OS - 




no 


Output Saved lines. 


.ns space 




no 


No-Space mode on. 


.r s - 




no 


Restore Spacing. 


.xh off 




no 


SCtra-Half -line mode on. 


IV. Line Length 


and Ind ent ing 




.11 +N N=65 


N=pr ev 


no 


Line Length. 


.in +N N=0 


N=sprev 


yes 


JNdent. 


•ti +N 


N=1 


yes 


Temporary Jndent. 


V. Macros. Diversion, and 


Line 


Traps 


.de XX — 


ignored 


no 


DEf ine or redefine a mac 


.rm XX - 




no 


ReMove macro name. 


.di XX - 


end 


no 


Divert output to macro 


.wh -N XX 




no 


WHen; set a line trap. 


.ch -N ~M 




no 


OR- 


.ch XX -M 




no 


OR- 


.ch -N y 




no 


OR- 


.ch XX y 




no 


CHange trap line. 



XX 



VI. Number Registers 



.nr a +N -M - 

.nr ab ^fN^-M - 

.nc c \n \n 

.ar arabic - 



no OR- 

no Number Register, 

no Number Character, 

no Arabic numbers. 
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arable 




no 


Roman numbers. 


.RO 




arable 


- 


no 


ROMAN numbers. 


VII. 


Input and 


Output 


Conventions and Character Translations 


.ta 


N, 




none 


no 


PseudoTAbs setting. 


.tc 


c 


space 


space 


no 


Tab replacement Character. 


.Ic 


c 


• 


• 


no 


Leader replacement Character. 


.ul 


N 




N=1 


no 


UNderline Input text lines. 


.cc 


c 


• 


• 


no 


Basic Control Character. 


,c2 


c 






no 


Nobreak control character. 


.li 


N 




N=1 


no 


Accept Input lines Literally. 


.tr 


abed • • • • 




no 


TRanslate on output. 



VIII. Hyphenation . 



.nh 
.he c 



on 
on 

none 



none 

IX. Three Part Titles . 

.tl 'left 'center 'right ' 
.It N N=65 N=prev 

X. Output Line Numbering . 



.nm +N M S I 
.np MSI 



off 
reset 



no No Hyphen, 
no Hyphenate. 

no Ilyphenatlon Indicator Character. 



no T ItLe . 

no Length of Title. 



no Number Mode on or off, set paurameters. 
no Number Parameters set or reset. 



XI. Oondltlonal Input Line Accept ance 



.If c anything - no OR- 

,lf !c anything - no OR- 

.If N anything - no OR- ^ , 

.If !N anything - no IF true accept line of "anything 



XII. Environment Switching . 

.ev N Ns=0 N=prev no Environment switched. 

XIII, Insert Ions from the Standard Input Stream 



.rd prompt 
.ex — 



bell 



XIV. Input File Switching 

.so filename - 
.nx filename - 
.sp 

XV, Miscellaneous 

.ig 
.fl 

.ab - - 



no ReaD Insert, 
no Exit. 



no Switch source file (push down), 
no NeOCt file. 



no IGnore, 

no FLush output buffer 

no ABort. 
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NAME 

SYNOPSIS 

DESCRIPTION 



Od — octal dump 

2^ [ -abcdho ] [ file ] [ [+]offset[J [b] ] 

od dumps file in one or more formats as selected 
'By the first argument, (if the first argument is 
missing, is default,) The meanings of the for- 
mat argument characters arej 

a interprets words as PDP-1 1 instructions and 
dis-assembles the operation code* Unknown 
operation codes print as ???. 

b interprets bytes in octal. 

c interprets bytes in ascii. Unknown ascii 
characters are printed as \?. 

d interprets words in decimal. 

h interprets words in hex. 

o interprets words in octal. 

The file argument specifies which file is to be 
dumped. If no file argument is specified, the 
standard input is used. Thus od can be used as a 
filter. 

The offset argument specifies the offset in the 
file where dumping is to commence. This argument 
is normally interpreted as octal bytes. If 
is appended, the offset is interpreted in de- 
cimal. If b' is appended, the offset is inter- 
preted in blocks. (A block is 512 bytes.) If the 
file argument is omitted, the offset argument 
must be preceded by '+*. 

Dumping continues until an end-of-f ile condition 
or until halted by sending an interrupt signal. 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



db(l) 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



opr — Off line print 

oar [^] [-] [+] [+:^]file^ ... 

opr will arrange to have the 201 data phone dae- 
mon submit a job to the Honeywell 6070 to print 
the file arguments. Normally, the output appears 
at the GCOS central site. If the first argument 
is ~, the output is remoted to station R1 . 
(station R1 has a 1403 printer.) 

Normally, each file is printed in the state it is 
found when the data phone daemon reads it. If a 
particular file argument is preceded by +, or a 
preceding argument of + has been encountered, 
then opr will make a copy for the daemon to 
print. If the file argument is preceded by or 
a preceding argument of - has been encountered, 
then opr will unlink (remove) the file. 

If there are no arguments except for the optional 
— « then the standard input is read and off-line 
printed. Thus opr may be used as a filter. 



/usr/dpd/* 
/etc/pa sswd 
/etc/dpd 



spool area 

personal ident cards 
daemon 



dpd(l), passwd(v) 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



OV — overlay pages 
OV [file ] 

OV is a postprocessor for producing double column 
formatted text when using nroff(l). ov literally 
overlays successive pairs of 66-line pages* 

If the file argument is missing, the standard 
input is used. Thus ov may be used as a filter, 

none 

nroff(l), pr(l) 
none 

Other page lengths should be permitted. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



passwd — set login password 
passwd name password 

The password is placed on the given login name. 
This can only be done by the user ID correspond- 
ing to the login name or by the super-user. An 
explicit null argument ("") for the password 
argument will remove any password from the login 
name. 

/etc/passwd 

login(l), passwd(v), crypt (ill) 

Diagnostics are given for a non-match of the 
login name, lack of permission and for password 
file format errors. 



BUGS 
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NAME 

SYNOPSIS 

DESCRIPTION 



pr — print file 

£T [:;:cm] name] [-n] [+n] [file^ ...] 

pr produces a printed listing of one or more 
files. The output is separated into pages headed 
by a date, the name of the file or a header (if 
any), and the page number. If there are no file 
arguments, jor prints the standard input file, and 
is thus usable as a filter. 

Options apply to all following files but may be 
reset between files: 

~c print current date 

-m print date file last modified (default) 

-n produce n-column output 

+n begin printing with page n 

~h treats the next argument as a header 

If there is a header in force, it is printed in 
place of the file name. 

Interconsole messages via write (l) are forbidden 
during a pr . 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



/dev/tty? to suspend messages. 
cat(l), cp(l) 

none (files not found are ignored) 

In multi-column output, non-printing characters 
other than new-line cause misalignment. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



proof — compare two text files 
proof oldfile newfile 

proof lists those lines of newfile that differ 
from corresponding lines in oldfile. The line 
number in newfile is given. When changes, inser- 
tions or deletions have been made the program 
attempts to re synchronize the text in the two 
files by finding a sequence of lines in both 
files that again agree. 



cmpd ) 

yes, but they are undecipherable, e.g. 



?1 



proof is still evolving. Any bugs discovered or 
.suggestions should be brought to ENP. 
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NAME 

SYNOPSIS 

DESCRIPTION 



reloc — relocate object files 
reloc file [-] octal [ - ] 

reloc modifies the named object program file so 
that it will operate correctly at a different 
core origin than the one for which it was assem- 
bled or loaded. 

The new core origin is the old origin increased 
by the given octal number (or decreased if the 
number has a "-" sign) • 

If the object file^was generated by the link- 
editor Id, the "-r" Id option must have been 
given to preserve the relocation information in 
the file. 

If the optional last argument is given, then any 
"setd" instruction at the start of the file will 
be replaced by a no-op. 

The purpose of this command is to simplify the 
preparation of object programs for systems which 
have no relocation hardware. It is hard to ima- 
gine a situation in which it would be useful to 
attempt directly to execute a program treated by 
reloc. 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



as(l), ld(l), a.out(v) 
As appropriate 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 
DIAGNOSTICS 



rew — rewind tape 
rew [ [m]digit ] 

rew rewinds DECtape or magtape drives. The digit 
is the logical tape number, and should range from 
to 7. If the digit is preceded by 'm', rew 
applies to magtape rather than DECtape. A miss- 
ing digit indicates drive 0. 

/dev/tap? 
/dev/mt? 



if there is no tape mounted on the indicated 
drive or if the file cannot be opened. 



BUGS 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



rm — remove (unlink) files 

[ ] C zl ] name^ ... 

rm removes the entries for one or more files from 
a directory. If an entry was the last link to 
the file, the file is destroyed. Removal of a 
file requires write permission in its directory, 
but neither read nor write permission on the file 
itself. 

If there is no write permission to a file desig- 
nated to be removed, rm will print the file name, 
its mode and then read a line from the standard 
input. If the line begins with 'y*, the file is 
removed, otherwise it is not. The optional argu- 
ment ^ prevents the above interaction. 

If a designated file is a directory, an error 
comment is printed unless the optional argument 
-r has been used, in that case, rm recursively 
deletes the entire contents of the specified 
directory. To remove directories per se see 
rmdir(l). 

/etc/glob to implement ^ flag 
rmdir(l) 

]]name: non existent" 

"name: not removed" if cannot remove 

"name: try again" error from fork 

When rm removes the contents of a directory under 
the ^ flag, full pathnames are not printed in 
diagnostics. 



RMDIR (I) 
NAME 

SYNOPSIS 
DESCRIPTION 

PILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



3/15/72 RMDIR (l) 



rradir — remove directory 
rmdlr dir^ . . , 

rmdlr removes (deletes) directories. The direc- 
tory must be empt^ (except for the standard en- 
tries and , which rmdir itself removes). 
Write permission is required in the directory in 
which the directory appears. 

none 



''dir?" is printed if directory dir cannot be 
found, is not a directory, or is not removable. 

"dir — directory not empty" is printed if dir 
has entries other than or 
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NAME 

SYNOPSIS 

DESCRIPTION 



roff — format text 

roff [ +number ] [ ^ ] [ ^ ] file^ 

roff formats text according to control lines 
embedded in the text in files name., . 
Encountering a nonexistent file terminates print- 
ing. The optional argument "inumber" causes 
printing to begin at the first gage with that 
number. The optional surgument -s ** causes print- 
ing to stop before each page including the first 
to allow paper manipulation; printing is resumed 
upon receipt^of ^an interrupt signal. The option- 
al argument "-h" causes the output to contain 
horizontal tabs for two or more spaces that end 
on a tab stop. An interrupt signal received d\ir- 
ing printing terminates all printing. Incoming 
interconsole messages are turned off during 
printing, and the original message acceptance 
state is restored upon termination. 

At the present time, there is no docviment 
describing ROFF in full . A Request Summary is 
attached. 



FILES 



/etc/suftab 
/tmp/rtm? 



suffix hyphenation tables 
t empor cury 



SEE ALSO 

DIAGNOSTICS none 
BUGS 
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REQUEST SUMMARY 



Request Break Initial Meanlncr 



• ad 




yes 


yes 


Begin adjusting right margins • 


• ar 




no 


arable 


Arabic page numbers. 


.br 




yes 


— 


Causes a line break — the filling of the 
current line Is stopped. 


.bl 


n 


yes 


— 


Insert contiguous block of n blank lines. 
If necessary, a new page will be started 
to accomodate the entire block. 


•bp 


+n 


yes 


n=1 


Begin new page and number It n. If n Is 










not given, normal sequencing occurs. 
Control character becomes *c'. 


.cc 


c 


no 


c=. 


• ce 


n 


yes 


— 


Center the next n Input lines, without 
filling. ^ ^ 


•de XX 


no 




Define macro named xx (definition ends 










with a line beginning with ".."). 


•ds 




yes 


no 


Double space; saune as ".is 2". 


.ef 


t 


no 




Even foot title becomes t. 


• eh 


t 


no 


t="" 


Even head title becomes t. 


•fl 




yes 




Begin filling output lines. 


•fo 




no 


All foot titles are t. 


•he 


c 


no 


none 


Hyphenation character set to *c'. 


•he 


t 


no 


t="" 


All head titles are t. 


• hx 




no 




Title lines are suppressed. 


•hy 


n 


no 


n=1 


Hyphenation is done, if n=1 ; and is not 
done, if n=0. 


.ig 




no 


mm 


Ignore input lines until and including a 
line beginning with 


• In 


+n 


yes 




Indent n^ spaces from left margin. 


• Ix 


+n 


no 




Same as " . in" but without br eak . 


• 11 


n 


no 


mm 


Literal, treat next n lines as text. 


• 11 


+n 


no 


n=65 


Line length including indent is n charac- 
ters. 


• Is 


+n 


yes 


n=1 


Line spacing set to n lines per outpiit 
line. 


• m1 


n 


no 


n=2 


n blank lines are put between the top of 
a new page and the head title. 


• m2 


n 


no 


n=:2 


n blanks lines put between head title and 
beginning of text on page. 


• mS 


n 


no 


n=1 


n blank lines put between the end of text 
and the foot title. 


• m4 


n 


no 


n=3 


n blank lines put between the foot title 
and the bottom of page. 


• na 




yes 


no 


Stop adjusting the right margin. 


•ne 


n 


no 




Begin new page, if n output lines cannot 
fit on present page. 


•nn 


+n 


no 




The next n output lines are not numbered. 


•n1 




no 


no 


Output lines are niimbered sequentially 
beginning with 1 on each new page. Head 
and foot titles are not numbered. 


•n2 




no 


no 


Output lines are numbered sequentially 
beginning with 1 on the next output line. 


•nl 


+n 


no 


n=0 


Line n\jmbers are indented n. 
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.nf 




yes 


no 


•nx 


filename 




•or 


t 


no 


4.-.* ♦ ♦ » 


•oh 


t 


no 




•pa 


+n 


yes 


n=1 


.Pl 


+n 


no 


n=66 


•po 


+n 


no 


n=0 


•ro 




no 


arable 


• sk 


n 


no 




• sp 


n 


yes 


- 


• ss 




yes 


yes 


,ta 


N M 


• • • 




,tc 


c 


no 


t» ft 

c= 


•ti 


+n 


yes 




•tr 


abed , , no 




•ul 


n 


no 





Stop filling output lines. 
Change to input file "filename". 
Odd foot title becomes t. 
Odd head^title becomes t. 
Same as ".bp". 

Total paper length taken to be n lines. 
Page offset. All lines are preceded by N 
spaces. 

Roman page numbers. 

n pages with head and foot titles but 
otherwise blank will be outp\at beginning 
with the next page containing text. 
Insert block of n blank lines. If the 
bottom of a page is reached, remaining 
lines are not put on next page. 
Single space output lines, equivalent to 
"•is 1-. 

Pseudotab settings. Initial tab settings 

are colxamns 9,17,25,... 

T ab r epl ac ement ch ar act er b ecome s " c" . 

Temporarily indent next output line n 

spaces. 

Translate a into b, c into d, etc. 
Underline the letters and numbers on the 
next n ir^ut lines. 
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NAME sh — shell (command interpreter) 

SYNOPSIS sh [ name [ arg^ ... [ argg ] ] ] 

DESCRIPTION 

sh is the standard command interpreter. It is the pro- 
gram which reads and arranges the execution of the com- 
mand lines typed by most users. It may itself be called 
as a command to interpret files of commands. Before dis- 
cussing the arguments to the shell used as a command, the 
structure of command lines themselves will be given. 

Command lines 

Command lines are sequences of commands separated by com- 
mand delimiters* Each command is a sequence of non-blank 
command arguments separated by blanks. The first argu- 
ment specifies the name of a command to be executed. 
Except for certain types of special arguments discussed 
below, the arguments other than the command name are 
passed without interpretation to the invoked command. 

If the first argument is the name of^an executable file, 
it is invoked; otherwise the string "/bin/" is prepended 
to the argument.^ (in this way most standard commands, 
which reside in "/bin", are found.) If no such command is 
found, the string "/usr" is further prepended (to give 
"/usr/bin/command" ) and another attempt is made to exe- 
cute the^resultin^ file, (Certain "overflow" commands 
live in "/usr/bin .) If the "/usr /bin" file exists, but 
is not executable, it is used by the shell as a command 
file. That is to say it is executed as though it were 
typed from the console. If all attempts fail, a diagnos- 
tic is printed. 

The remaining non-special arguments are simply passed to 
the command without further interpretation by the shell. 

Command delimiters 

There are three command delimiters: the new-line, ";", 
and "&". The semicolon ";" specifies sequential execu- 
tion of the commands so separated; that is, 

coma; comb 

causes the execution first of command coma , then of comb . 
The ampersand "&" causes simultaneous execution? 

coma & comb 

causes coma to be called, followed immediately by comb 
without waiting for coma to finish. Thus coma and comb 
execute simultaneously. As a special case. 



coma & 
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causes coma to be executed and the shell immediately to 
request another command without waiting for coma. 

Termination Reporting 

If a command (not followed by ) terminates abnormally, 
a message is printed. (All terminations other than exit 
and interrupt are considered abnormal.) The following is 
a list of the abnormal termination messages: 

Bus error 

Trace/BPT trap 

Illegal instruction 

lOT trap 

Power fail trap 

EMT trap 

Bad system call 

Quit 

PIR trap 

Floating exception 

Memory violation 

Killed 

User I/O 

Error 

If & core image is produced, " — Core dumped" is append- 
ed to the appropriate message. 

Redirection of I /o 

Three character sequences cause the immediately following 
string to be interpreted as a special argument to the 
shell itself, not passed to the command. 

An argument of the form *'<arg'' causes the file arq to be 
used as the standard input file of the given command. 

An argument of the form *'>arg'' causes file "arg" to be 
used as the standard output file for the given command. 
"Arg" is created if it did not exist, and in any case is 
truncated at the outset. 

An argument of the form ''»arg*' causes file "arg" to be 
used as the standard output for the given command. If 
"arg" did not exist, it is created; if it did exist, the 
command output is appended to the file. 

Pipes and Filters 

A pipe is a channel such that information can be written 
into one end of the pipe by one program, and read at the 
other end by another program. (See pipe (ll)). A filter 
is a program which reads the standard input file, per- 
forms some transformation, and writes the result on the 
standard output file. By extending the syntax used for 
redirection of I/O, a command line can specify that the 
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output produced by a command be passed via a pipe through 
another command which acts as a filter. For example; 

command >filter> 
More generally, special arguments of the form 

>f^>f2>...> 

specify that output is to be passed successively through 
the filters f . ^ f^, and end up on the standard out- 

put stream. By saying instead 

>f^>f2>. ..>file 

the output finally ends up in file , (The last could 
also have been a »'* to specify concatenation onto the 
end of file, ) 

In exactly analogous manner input filtering can be speci- 
fied via one of 

<f.<f2<,..< 
<f]<f2<...<file 

Both input and output filtering can be specified in the 
same command, though not in the same special argument. 

For example : 

Is >pr> 

produces a listing of the current directory with page 
headings, while 

Is >pr>xx 

puts the paginated listing into the file xx. 

If any of the filters needs arguments, quotes can be used 
to prevent the required blank characters from violating 
the blankless syntax of filters. For example: 

Is >*'pr -h 'My directory 

uses quotes twice, once to protect the entire pr command, 
once to protect the heading argument of £r, (Quotes are 
discussed fully below,) 

Generation of argument lists 

If any argument contains any of the characters "-)''^ 
or '[ , it^ is treated specially as follows. The current 
directory is searched for files which match the given 
argument. 
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The character ***** in an argument matches any string of 
characters in a file name (including the null string). 

The character **?*' matches any single character in a file 
name. 

Square brackets **[...]** specify a class of characters 
which matches any single file-name character in the 
class. Within the brackets, each ordinary character is 
taken to be a^member of the class. A pair of characters 
separated by **-** places in the class each character lexi- 
cally greater than or equal to the first and less than or 
equal to the second member of the pair. 

Other characters match only the same character in the 
file name. 

For example, ****** matches all file names; "?** matches all 
one-character file names; **[abl*.s'' matches all file 
names be chinning with ''a** or '*b and ending with .s"; 
'*?[zi-mj matches all two-character file names ending 
with "z or the letters *'i*' through "m**. 

If the argument with ***** or **?** also contains a *'/^, a 
slightly different procedure is used: instead of the 
current directory, the directory used is the one obtained 
by taking the argument up to the last **/** before a **♦" or 
'*?**. The matching process matches the remainder of the 
argument after this "y" against the files in the derived 
directory. For example: '*/usr/dmr/a*,s*' matches all 
files in directory *'/usr/dmr** which begin with **a*' and 
end with **.s''. 

In any event, a list of names is obtained which match the 
argument. This list is sorted into alphabetical order, 
and the resulting sequence of arguments replaces the sin- 
gle argument containing the ** [" , or **?" • The same 
process is carried out for each argument (the resulting 
lists are not merged) and finally the command is called 
with the resulting list of arguments. 

For example: directory /usr/dmr contains the files al.s, 
a2.s, ..•» a9.s. From any directory, the command 

as /usr/dmr/a?.s 

calls as with arguments /usr/dmr/a1 .s , /usr/dmr/a2.s , ... 
/usr/dmr/a9.s in that order. 

Quoting 

The character "X** causes the immediately following char- 
acter to lose any special^meaning it may have to the 
shell; in this way **<**, **>**, and other characters mean- 
ingful to the shell may be passed as part of arguments. 
A special case of this feature allows the continuation of 
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commands onto more than one line: a new-line preceded by 
"X" is translated into a blank. 

Sequences of characters enclosed in double ('*) or single 
(') quotes are also taken literally. 

Argument passing 

When the shell is invoked as a command, it has additional 
string processing capabilities. Recall that the form in 
which the shell is invoked is 

sh [name [ arg^ ... [ argg ] ] ] 

The name is the name of a file which will be read and 
interpreted. If not given, this subinstance of the shell 
will continue to read the standard input file. 

In command lines in the file (no^ ip command input), 
character sequences of the form $n , where n is a digit 
0, 9, are replaced by the nth argument to the invo- 

cation of the shell (arg^) . *'$o'' is replaced by name . 

End of file 

An end-of-file in the shell's input causes it to exit. A 
side effect of this fact means that the way to log out 
from UNIX is to type an end of file. 

Special commands 

Two commands are treated specially by the shell. 

"chdir" is done without spawning a new process by execut- 
ing the sys chdir primitive. 

"Login" is done by executing /bin/login without creating 
a new process. 

These peculiarities are inexorably imposed upon the shell 
by the basic structure of the UNIX process control sys^ 
tem. It is a rewarding exercise to work out why. 

Command file errors ; interrupts 

Any shell-detected error, or an interrupt signal, during 
the execution of a command file causes the shell to cease 
execution of that file. , 

FILES /etc/glob, which interprets "?",, and "[". 

SEE ALSO "The UNIX Time-sharing System", which gives the 

theory of operation of the shell. 

DIAGNOSTICS 

"input not found", when a command file is specified which 
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cannot be read; 

'*Arg count", if the number of arguroents^^to the^chdir^ 
pseudo-command is not exactly 1, or if or " [" 

is used inappropriately; 

"Bad directory", if the directory given in "chdir" cannot 
be switched to; 

"Try again", if no new process can be created to execute 
the specif ied^command; 

""' imbalance", if single or double quotes are not 
matched; 

]|lnput file"^ if an argument after "^"^cannot be read; 
"output file , if an argument after >" or "»" cannot be 
written (or created); 

"command not found", if the specified command cannot be 
executed.^ 

"no match", if no arguments are generated for a command 
which contains ♦ , ? , or [ • 
Termination messages described above. 

BUGS If any argument contains a quoted "♦", "?", or " [" , then 
all instances of these characters must be quoted. This 
is because sh calls the glob routine whenever an unquoted 
"*", "?", or " [" is noticed; the fact that other in- 
stances of these characters occurred quoted is not no- 
ticed by glob . 

When output is redirected, particularly through a filter, 
diagnostics tend to be sent down the pipe and are some- 
times lost altogether. 
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DIAGNOSTICS 

BUGS 
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size — size of an object file 
size [ object ••• ] 

The size, in bytes, of the object files are 
printed. If no file is given, a,out is default. 
The size is printed in octal for the text, data, 
and bss portions of each file. The sum of these 
is also printed in octal and decimal, 

a, out default 



||object not found" if the input cannot be read. 
'*bad format: object" if the input file does not 
have a valid object header. 
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NAME 8 no — SNOBOL interpreter 

SYNOPSIS sno [file] 

DESCRIPTION sno is a SNOBOL III (with slight differences) 

compiler and interpreter, sno obtains input from 
the concatenation of file and the standard input. 
All input through a statement containing the 
label end' is considered program and is com- 
piled. The rest is available to 'syspit'. 

The following is a list of differences between 
sno and SNOBOL III: 

There are no unanchored searches. To get the 
same effect: 

a *♦ b unanchored search for b 

a ♦x* b s X c unanchored assignment 

No back referencing 

X = abc 

a *x* X unanchored search for "abc" 

Different function declaration. The function 
declaration is done at compile time by the use 
of the label 'define*. Thus there is no abil- 
ity to define functions at run time and the 
use of the name 'define' is preempted. There 
is also no provision for 'automatic' variables 
other than the parameters. 

define f() 
or 

define f(a,b,c) 

All labels except 'define' (even 'end') must 
have a non-empty statement. 

If 'start' is a label in the program, program 
execution will start there. If not, execution 
begins with the first executable statement, 
('define' is not an executable statement) 

There are no builtin functions. 

Variable length patterns at the end of a pat- 
tern match are not treated specially. They 
still match the shortest rather than longest 
text. 

Parentheses for arithmetic are not needed. 
Normal (eg FORTRAN) precedence applies. Be- 
cause of this, the arithmetic operators '/' 
and '*' must be set off by space. 
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FILES 
SEE ALSO 

DIAGNOSTICS 
BUGS 



The right side of assignments must be non- 
empty • 

Either ' or ** may be used for literal quotes. 
The pseudo-variable 'sysppt' is not available. 



SNOBOL III manual. ( JACM ; Vol. 11 No. 1; Jan 
1964; pp 21 ) 

As appropriate 

Runtime diagnostics give the last program line 
number rather than the executing statement line 
number. 
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NAME 

SYNOPSIS 

DESCRIPTION 



sort 



sort a file 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



sort [ - ] [ input [ output ] ] 

sort will sort the input file and write the sort- 
ed file on the output file* If the output file 
is not given, the input file is rewritten. If 
the input file is missing, sort uses the standard 
input as input and the standard output for out- 
put. Thus sort may be used as a filter. 

The sort is line-ty-line in increasing ASCII col- 
lating sequence, except that upper-case letters 
are considered the same as the lower-case 
letters. 

The optional argument - will cause a reverse 
sort. " 

sort is implemented in such a way that 

sort /dev/mtO 

works correctly provided the tape is not too big. 

/tmp/ stm? 



The largest file that can be sorted is about 1 28K 
bytes. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



split — split a file into pieces 
split [ [ file1 ] file2 ] 

Split reads filel and writes it in 1000-line 
pieces y as many as are necessary , onto a set of 
output files. The name of the first output file 
is file2 with an "a" appended, and so on through 
the alphabet and beyond. If no output name is 
given, "x" is default. 

If no ^ input file is given, or the first argument 
is then the standard input file is used. 



yes 

Watch out for 8-character file names. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
BUGS 



speak — word to voice translator 
speak [ - ] [ vocabulary ] 

speak turns a stream of ascii words into utter- 
ances and outputs them to a voice synthesizer. 
It has facilities for maintaining a vocabulary. 
It receives, from the standard input 

- working lines - text of words separated by 
blanks 

- phonetic lines - strings of phonemes for one 
word preceded and separated by commas. The 
phonetic code is given in vsp (vil ) . 

- empty lines 

- command lines - beginning with 2. The follow- 
ing forms are recognized: 

Ir file replace coded vocabulary from file 
Jw file write coded vocabulary on file 
!p print phonetics for working word 

II list vocabulary on standard output 

with phonetics 
!c word copy phonetics from working word to 

specified word 
I s file (save) append working word and phonet- 
ics to file in style of I 1 

Each working line replaces its joredecessor. Its 
first word is the "working word . Each phonetic 
line replaces the phonetics stored for the work- 
ing word. Each working line, phonetic line or 
empty line causes the working line to be uttered. 
The process terminates at the end of input. 

Unknown words are spelled as strings of one- 
letter words. Unknown one-letter words burp. 

A phonetic line of comma only will delete the 
entry for the working word. 

speak is initialized with a coded vocabulary 
stored in file / etc / speak .m. The vocabulary 
option substitutes a different file for speak .m . 

The - option suppresses all utterances. 

/etc/speak.m 

vsp(VIl), speakm(v), vt(iv) 

Vocabulary overflow is unchecked. Excessively 
long words cause dumps. Space is not reclaimed 
from deleted entries. 
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NAME 

SYNOPSIS 

DESCRIPTION 



Stat — get file status 



FILES 

SEE ALSO 

DIAGNOSTICS 



Stat name 



Stat gives several kinds of information about one 
or more files: 

i -number 
access mode 
number of links 
owner 

size in bytes 

date and time of last modification 

name (useful when several files are named) 

All information is self-explanatory except the 
mode. The mode is a six-character string whose 
characters mean the following: 

1 s: file is small (smaller than 4096 bytes) 
1: file is large 

2 d: file is a directory 
x: file is executable 

u: set user ID on execution 
-; none of the above 

3 r: owner can read 

-: owner cannot read 

4 w: owner can write 

-; owner cannot write 

5 r: non-owner can read 

-: non-owner cannot read 

6 w: non-owner can write 

-: non-owner cannot write 

The owner is almost always given in symbolic 
form; however if he cannot be found in 
"/etc/passwd" a number is given. 

If the number of arguments to stat is not exactly 
1a header is generated identifying the fields of 
the status information. 

/etc/pa ssWd 

istat(l), ls(l) (-1 option) 
"name?" for any error. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



Strip — remove symbols and relocation bits 
strip name^ , . . 

strip removes the symbol table and relocation 
bits ordinarily attached to the output of the 
assembler and loader* This is useful to save 
space after a program has been debugged. 

The effect of strip is the same as use of the ~s 
option of Id. 



/tmp/ stm? 
ld(l), as(l) 



temporary file 



Diagnostics are given for; non-existent argument; 
inability to create temporary file; 
improper format (not an object file); 
inability to re-read temporary file. 



BUGS 
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stty — set teletype options 
sttv option^ ... 

Stty will set certain l/o options on the current 
output teletype. The option strings are selected 
from the following set: 



even 

-even 

odd 

-odd 

raw 



-raw 
-nl 

echo 

-echo 

lease 

-lease 

-tabs 

tabs 

delay 

-delay 

ebcdic 

cor res 



allow even parity, 
disallow even parity, 
allow odd parity 
disallow odd parity 
raw mode input 

( no erase/lcill/ interrupt/quit/EOT ) 
negate raw mode 

allow cr for If (and echo If cr) 
allow nl only 

echo back every character typed. 

do not echo characters . 

map upper case to lower case 

do not map case 

replace tabs by spaces 

preserve tabs 

calculate cr and tab delays, 
no cr/tab delays 

ebcdic ball conversion (2741 only) 
correspondence ball conversion (2741 only) 



standard output, 
stty (II) 
"Bad options" 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



sum 



sum name 



sum file 



1 ••• 

sum sums the contents of the bytes (mod 2*^16) of 
one or more files and prints the answer in octal, 
A separate sum is printed for each file speci- 
fied, along with the number of whole or partial 
512-byte blocks read. 

In practice, sum is often used to verify that all 
of a special file can be read without error. 

none 



oprd if the file cannot be opened; 
error is discovered during the read. 



? if an 



BUGS 



none 
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NAME tap — manipulate DECtape 

SYNOPSIS tap [ key ] [ name ... ] 

DESCRIPTION tap saves and restores selected portions of the 

file system hierarchy on DECtape. Its actions 
are controlled by the key argument. The key is a 
string of characters containing at most one func- 
tion letter and possibly one or more function 
modifiers. Other arguments to the command are 
file or directory names specifying which files 
are to be dumped, restored, or tabled. 

The function portion of the key is specified by 
one of the following letters : 

r The indicated files and directories, to- 
gether with all subdirectories, are dumped 
onto the tape. If files with the same 
names already exist, they are replaced 
(hence the "r"). "same" is determined by 
string comparison, so "./abc" can never be 
the same as "/usr/dmr/abc" even if 
"/usr/dmr" is the current directory. If no 
file argument is given, is the default. 

u updates the tape, u is the same as r, but 
a file is replaced only if its modification 
date is later than the date stored on the 
tape; that is to say, if it has changed 
since it was dumped, u is the default com- 
mand if none is given. 

d deletes the named files and directories 
from the tape. At least one file argument 
must be given. 

X extracts the named files from the tape to 
the file system. The owner, mode, and 
date-modified are restored to what they 
were when the file was dumped. If no file 
argument is given, the entire contents of 
the tape are extracted. 

t lists the names of all files stored on the 
tape which are the same as or are hierarch- 
ically below the file arguments. If no 
file argument is given, the entire contents 
of the tape are tabled. 

1 is the same as t except that an expanded 
listing is produced giving all the avail- 
able information about the listed files. 

The following characters may be used in addition 
to the letter which selects the function desired. 
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0, 7 This modifier selects the drive on 

which the tape is mounted, "o" is the 
default. 

V Normally tap does its work silently. The v 
(verbose) option causes it to type the name 
of each file it treats preceded by a letter 
to indicate what is happening. 

r file is being replaced 

a file is being added (not there before) 

X file is being extracted 

d file is being deleted 

The V option can be used with r, u, d, and 
X only. 

c means a fresh dump is being created; the 
tape directory will be zeroed before begin- 
ning. Usable only with r and u. 

f causes new entries copied on tape to be 

'fake' in that no data is present for these 
entries. Such fake entries cannot be ex- 
tracted. Usable only with r and u. 

w causes tap to pause before treating each 
file, type the indicative letter and the 
file name (as with v2 await the user's 
response. Response y" means "yes", so the 
file is treated. Null response means "no", 
and the file does not take gart in whatever 
is being done. Response "x means "exit"; 
the tap command terminates immediately. In 
the X f u nc ti on , f i le s pre vi ou sly a sked 
about have been extracted already. With r, 
u, and d no change has been made to the 
tape • 

m make (create) directories during an x if 
necessary. 

FILES /dev/tap? 



SEE ALSO mt(l) 

DIAGNOSTICS Tape open error 

Tape read error 
Tape write error 
Directory checksum 
Directory overflow 
Tape overflow 

Phase error (a file has changed after it was 
selected for dumping but before it was dumped) 

BUGS Asks about "fake" entries on "xw", when it should 
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ignore them. If a fake entry is extracted, and 
the file already exists on disk, the extraction 
does not take place (as is correct), but the mode 
and user ID of the file are set to 0. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



time — time a command 
time command 

The given command is timed; after it is complete, 
time prints the time spent in the system, waiting 
for disk, and in execution of the command. 

The disk I/O time can be variable depending on 
other activity in the system. 



tm (VIII) 

? 

"command terminated abnormally' 
"command not found." 
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NAME 

SYNOPSIS 

DESCRIPTION 



tmg 



compiler compiler 



FILES 



SEE ALSO 



DIAGNOSTICS 



BUGS 



tmg name 

tmg produces a translator for the language whose 
parsing and translation rules are described in 
file name»t. The new translator appears in a. out 
and may be used thus: 

a «out input [ output ] 

Except in rare cases input must be a randomly 
addressable file. If no output file is speci- 
fiedy the standard output file is assumed* 

/sys/tmg/tmgl.o — the compiler-compiler 
/sys/tmg[abc] — libraries 
alloc .d — table storage 

A Manual for the Tmg Compiler-writing Language, 
MM-72-1271-8* 

Syntactic errors result in "???" followed by the 
offending line. 

Situations such as space overflow with which the 
Tmg processor or a Tmg-produced processor can not 
cope result in a descriptive comment and a dump. 

9.2 footnote 1 is not enforced, causing trouble. 
Restrictions (7.) against mixing bundling primi- 
tives should be lifted. 

Certain hidden reserved words exist; gpar, 
classtab, trans. 

Octal digits include 8=10 and 9=11. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



tss — interface to Honeywell TSS 
tss 

tss will call the Honeywell 6070 on the 201 data 
phone. It will then go into direct access with 
TSS. Output generated by TSS is typed on the 
standard output and input requested by TSS is 
read from the standard input with UNIX typing 
conventions . 

A n^ interrupt signal (ASCII DEL) is transmitted as 
a "break" to TSS. 

Input lines beginning with _[ are interpreted as 
UNIX commands. Input lines beginning with 2 
interpreted as commands to the interface routine. 

"'<file insert input from named UNIX file 

'">file deliver tss output to named UNIX file 

^'p pop the output file 

'"'q disconnect from tss (quit) 

'"r file receive from HIS routine CSR/DACCOPY 

"s file send file to HIS routine CSR/DACCOPY 

Ascii files may be most efficiently transmitted 
using the HIS routine CSR/DACCOPY in this 
fashion. Underlined text comes from TSS. 
AFTname is the 6070 file to be dealt with. 

SYSTEM? CSR/DACCOPY (s) AFTname 
Send Encoded File ''s file 

SYSTEM ? CSR/DACCOPY (r) AFTname 
Receive Encoded File '"r file 

/dev/dnO , /dev/dpO 



DONE when communication is broken. 

When diagnostic problems occur, tss exits rather 
abruptly . 



- 1 - 



TTY (l) 

NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



3/15/72 TTY (l) 

tty — get tty name 

tty gives^the name of the user's typewriter in 
the form "ttyn" for n a^digit. The actual path 
name is then "/dev/ttyn" . 



"not a tty" if the standard input file is not a 
typewriter. 
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TYPE (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



type — type on single sheet paper 



type file^ 



• • • 



type copies its input files to the standard out- 
put. Before each new page (66 lines) and before 
each new file, type stops and reads the standard 
input for a new line character before continuing. 
This allows time for insertion of single sheet 
paper. 
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TYPO (I) 



NAME 

SYNOPSIS 
DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



typo — find possible typo's 
typo [ - ] file^ ... 

typo hunts through a document for unusual words, 
typographic errors, and hapax legomena and prints 
them on the standard output. 

All words used in the document are printed out in 
decreasing order of peculiarity along with an 
index of peculiarity. An index of 10 or more is 
considered peculiar. Printing of certain very 
common English words is suppressed. 

The statistics for judging words are taken from 
the document itself; with some help from known 
statistics of English, The option suppresses 
the help from English and should be used if the 
document is written in, for example, Urdu. 

Roff and Nroff control lines are ignored. Upper 
case is mapped into lower case. Quote marks, 
vertical bars, hyphens, and ampersands are 
stripped from within words. Words hyphenated 
across lines are put back together, 

/tmp/ttmp??, /etc/salt, /etc/w2006 



yes, lots 

Because of the mapping into lower case and the 
stripping of special characters , words may be 
hard to locate in the original text. 
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UN (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



un — undefined symbols 
un [ name ] 

un prints a list of undefined symbols from an 
assembly or loader run. If the file argument is 
not specified, a .out is the default. Names are 
listed alphabetically except that non-global sym- 
bols come first. Undefined global symbols (un- 
resolved external references) have their first 
character underlined. 

a .out 

as(l), ld(l) 

if the file cannot be found. 
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UNIQ (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



uniq — report repeated lines in a file 

uniq [ -ud 1 [ input [ output ] ] 

uniq reads the input file comparing adjacent 
lines* In the normal case, the second and 
succeeding copies of repeated lines are removed; 
the remainder is written on the output file. 
Note that repeated lines must be adjacent in ord- 
er to be found. (See sort(l)) If the ^ flag is 
used, Just the lines that are not repeated in the 
original file are output. The ^option speci- 
fies that one copy of Just the repeated lines is 
to be written. Note that the normal mode output 
is the union of the ^ and ^ mode outputs. 

The following example will print one copy of all 
lines in the file a that do not occur in bj 

sort ax 
uniq X a1 
sort b X 
uniq X b1 
cat a1 b1 >x 
sort X 

uniq -u X »a1 
sort a1 
uniq -d al 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



sort (I) 

"cannot open input", "cannot create output' 
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VS(I) 



NAME 

SYNOPSIS 

DESCRIPTION 



VS — phoneme list to voice synthesizer 
vs 

vs accepts phoneme descriptor lists and 
translates them into byte strings suitable for 
the Federal Screw Works Voice Synthesizer. 
Phoneme descritors should ^e separated by commas 
and have the general form %NIxx'' where xx is a 
one or two character phoneme name, "l" is an 
optional inflection parameter, and "XN" is an 
optional count of the number of times the phoneme 
is to be repeated (rasiximiam 9). "l" can have the 
values 0, 1, 2, 3 representing decreasing 
strength (default is 2 ) • A description of the 
phonemes and their names can be found in the file 
vsp ( VII) » For example, 

aO,o1 ,t ,r , 1 ai, 1 ay,d, j , ih,u1 ,%2s 

will generate the word "outrageous". The outpxit 
is buffered; a newline will cause the buffered 
output to be sent to the Voice Synthesizer. 



FILES 
SEE ALSO 
DIAGONOSTICS 
BUGS 



vsp(VII), speak(l) 
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WC (l) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



WC — get (English) word count 
WC name^ ... 

WC provides a count of the words, text lines, and 
control lines for each argument file. 

A text line ij^ ^ s,fqyence„o| characters not be- 
ginning with . , ! or ' and ended by a new- 
line. A control line is a line beginning with 

"l" or A word is a sequence of charac- 

ters bounded by the beginning of a line, by the 
end of a line, or by a blank or a tab. 

When there is more than one input file, a grand 
total is also printed. 



roff(l) 

none; arguments not found are ignored. 
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WHO (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



who — who i s on the system 
who [ who-file ] 

who, without an argument, lists the name, type- 
writer channel, and login time for each current 
UNIX user. 

Without an argument, who examines the /tmp/utmp 
file to obtain its information. If a file is 
given, that file is examined. Typically the 
given file will be /tmp/wtmp . which contains a 
record of all the logins since it was created. 
Then who will list logins, logouts, and crashes 
since the creation of the wtmp file. 

Each login is listed with user name, last charac- 
ter of input device name (with /dev/tty 
suppressed), date and time. Certain logouts pro- 
duce a similar line without a user name. Reboots 
produce a line with "x" in the place of the dev- 
ice name, and a fossil time indicative of when 
the system went down. 

/ tmp/utmp 

login(l), init(VIl) 

if a named file cannot be read. 
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WRITE (l) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



write — write to another user 
write user 

write copies lines from your typewriter to that 
of another user. When first called, write sends 
the message 

message from yourname«». 

The recipient of the message should write back at 
this point. Communication continues until an end 
of file is read from the typewriter or an inter- 
rupt is sent. At that point write writes "eot" 
on the other terminal. 

Permission to write may be denied or granted by 
use of the mesq command. At the outset writing 
is allowed. Certain commands, in particular rof f 
and 2r, disallow messages in order to prevent 
messy output. 

If the character "l" is found at the beginning of 
a line, write calls the mini -shell msh to execute 
the rest of the line as a command. 

The following protocol is suggested for using 
write ; When you first write to another user, wait 
for him to write back before starting to send. 
Each party should end each message with a dis- 
tinctive signal ("(o)" for "ovej is^convention- 
al) that the other may reply. (oo)" (for "over 
and out") is suggested when conversation is about 
to be terminated. 



/tmp/utmp 
/etc /msh 



to find user 
to execute ! 



mesg(l), m8h(VIl) 

"user not logged in"; "permission denied", 

write should check the mode of the other user's 
typewriter and refuse to proceed unless non-user 
write permission is given. Currently it is pos- 
sible to write to another person with the same 
user- ID even though he has forbidden messages. 

write should also allow specification of the 
typewriter name of a user who is logged in 
several times instead of picking out the instance 
with the lowest name. 
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BOOT (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 

DIAGNOSTICS 

BUGS 



boot — reboot UNIX 

sys boot / boot = 39. not in assembler 

UNIX will clean up outstanding l/O, and then exe- 
cute the reboot read-only program. This call is 
restricted to the super-user. All users will be 
logged out. 

boot procedures (VI I) 

the c-bit is set if you are not the super-user 

It often doesn't work (for unknown reasons). 
It depends on switch settings. 
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BREAK (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
DIAGNOSTICS 



break — set program break 
sys break; addr / break =17, 

break sets the system's idea of the highest loca- 
tion used by the program to addr. Locations 
greater than addr and below the stack pointer are 
not swapped and are thus liable to unexpected 
modification. 

An argument of is taken to mean 1 6K bytes. If 
the argument is higher than the stack pointer the 
entire user core area is swapped. 

When a program begins execution via exec the 
break is set at the highest location defined by 
the program and data storage areas. Ordinarily, 
therefore, only programs with growing data areas 
need to use break . 

exec ( II) 

none; strange addresses cause the break to be set 
at 16K bytes. 



BUGS 
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CEMT (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



cemt — - catch emt traps 
sys cerat; arg / cemt =s 29. 

This call allows one to catch traps resulting 
from the emt instruction. Arg is a location 
within the program; emt traps are sent to that 
location. The normal effect of emt traps may be 
restored by giving an arg equal to 0. 

To return after catching the emt trap, execute 
the rti instruction. 



SEE ALSO 

DIAGNOSTICS 

BUGS 



CHDIR (II) 
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CHDIR (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
DIAGNOSTICS 



chdir — change working directory 

sys chdir; dirname / chdir =12. 

dirname is the address of the pathname of a 
directory, terminated by a l:^te. chdir causes 
this directory to become the current working 
directory. 

chdir (I) 

The error bit (c-bit) is set if the given name is 
not that of a directory or is not readable. 



BUGS 
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CHMOD (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
DIAGNOSTICS 

BUGS 



chmod — change mode of file 

sys chmod; name; mode / chmod = ^5^ 

The file whose name is given as the null- 
terminated string pointed to by name has its mode 
changed to mode . Modes are constructed by oring 
together some combination of the following: 

01 write, non-owner 

02 read, non-owner 
04 write, owner 

10 read, owner 
20 executable 

40 set user ID on execution 

Only the owner of a file (or the super-user) may 
change the mode» 

chmod ( I ) 

Error bit (c-bit) set if name cannot be found or 
if current user is neither the owner of the file 
nor the super-user. 
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CHOWN (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
DIAGNOSTICS 



chown — change owner of file 

sys chown; name; owner / chown =16. 

The file whose name is given by the null- 
terminated string pointed to by name has its own- 
er changed to owner. Only the present owner of a 
file (or the super-user) may donate the file to 
another user. Also, one may not change the owner 
of a file with the set-user-ID bit on, otherwise 
one could create Trojan Horses. 

chown ( I ) , u ids ( V ) 

The error bit (c-bit) is set on illegal owner 
changes. 



BUGS 
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CLOSE (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



close 



close a file 



SEE ALSO 
DIAGNOSTICS 



(file descriptor in rO) 
sys close / close = 6, 

Given a file descriptor such as returned from an 
open or creat call, close closes the associated 
file* A close of all files is automatic on exit, 
but since processes are limited to 10 simultane- 
ously open files, close is necessary for programs, 
which deal with many files. 

creat(ll), open(ll) 

The error bit (c-bit) is set for an unknown file 
descriptor. 



BUGS 
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GREAT (II) 



NAME 
S'XNOPSIS 

DESGRIPTION 



SEE ALSO 
DIAGNOSTIGS 



creat — create a new file 

sys creat; name; mode 

(file descriptor in rO) 



/ creat =8. 



creat creates a new file or prepares to rewrite 
an existing file called name; name is the address 
of a null-terminated string. If the file did not 
exist, it is given mode mode ; if it did exist, 
its mode and owner remain unchanged but it is 
truncated to length. 

The file is also opened for writing, and its file 
descriptor is returned in rO. 

The mode given is arbitrary; it need not allow 
writing. This feature is used by programs which 
deal with temporary files of fixed names. The 
creation is done with a mode that forbids writ- 
ing. Then if a second instance of the program 
attempts a creat, an error is returned and the 
program knows that the name is unusable for the 
moment , 

write(ll), close(ll) 

The error bit (c-bit) may be set if: a needed 
directory is not readable; the file does not 
exist and the directory in which it is to be 
created is not writable; the file does exist and 
is unwritable; the file is a directory; there are 
already 10 files open. 



BUGS 
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CSW (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



SEE ALSO 

DIAGNOSTICS 

BUGS 



CSW — read console switches 

sys CSW / CSW = 38. not in assembler 
(value of CSW in rO) 
(value of buttons in r1 ) 

The setting of the console switches is returned 
in rO. The setting of the external buttons is 
returned in r1 • The return is synced to a 30 CPS 
clock for graphical applications. 



none 



Currently the buttons are unavailable. 
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DUP (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



SEE ALSO 
DIAGNOSTICS 



dup — duplicate an open file descriptor 

(file descriptor in rO) 

sys dup / dup = 41 not in assembler 

(file descriptor in rO) 

Given a file descriptor returned from an open or 
creat call . dup will allocate another file 
descriptor synonymous with the original. The new 
file descriptor is returned in rO. 

Dup i s used more to manipulate the value of file 
descriptors than to genuinely duplicate a file 
descriptor. Since the algorithm to allocate file 
descriptors is known to use the lowest available 
value between and 9, combinations of dup and 
close can be used to manipulate file descriptors 
in a general way. This is handy for manipulating 
standard input and/or standard output. 

creat(ll), open(ll), close(ll) 

The error bit (c-bit) is set if: the given file 
descriptor is invalid; there are already 10 open 
files. 



BUGS 
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EXEC (II) 



NAME exec — execute a file 

SYNOPSIS sys exec; name; args / exec =s 11 • 

• • • 

name: <...\0> 

• • • 

args: argi ; arg2; ...; 
argl : <.. .\0> 



DESCRIPTION exec overlays the calling process with the named 

file, then transfers to the beginning of the core 
image of the file. The first argument to exec is 
a pointer to the name of the file to be executed. 
The second is the address of a list of pointers 
to arguments to be passed to the file. Conven- 
tionally, the first argument is the name of the 
file. Each pointer addresses a string terminated 
by a null byte. 

There can be no return from the file; the calling 
core image is lost. 

The program break is set from the executed file; 
see the format of a .out. 

Once the called file starts execution, the argu- 
ments are available as follows. The stack 
pointer points to a word containing the number of 
arguments. Just above this number is a list of 
pointers to the argument strings. 

sp-> nargs 
argl 
'• • • 
argn 

argl : <arg1\0> 
• • • 

argn: <argn\0> 

The arguments are placed as high as possible in 
core: just below 57000(8). 

Files remain open across exec calls. However, 
the illegal instruction, emt, quit, and interrupt 
trap specifications are reset to the standard 
values. (See ilgins . cemt, quit , intr . ) 

Each user has a real user ID and an effective 
user ID (The real ID identifies the person using 
the system; the effective ID determines his ac- 
cess privileges.) exec changes the effective user 
ID to the owner of the executed file if the file 
has the "set-user-ID** mode. The real user ID is 
not affected. 
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EXEC (II) 



fork (II) 

If the file cannot be read or if it is not exe- 
cutable, a return from exec constitutes the diag- 
nostic. The error bit (c-bit) is set. 

Very high core and very low core are used by exec 
to construct the argument list for the new core 
image. If the original copies of the arguments 
reside in these places, problems can result. 
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EXIT (II) 



exit — terminate process 

(status in rO) 

sys exit / exit = 1 

exit is the normal means of terminating a pro- 
cess. Exit closes all the process' files and 
notifies the parent process if it is executing a 
wait. The low byte of rO is available as status 
to the parent process. 

This call can never return. 



wait(ll) 



FORK (II) 

NAME 
SYNOPSIS 

DESCRIPTION 

SEE ALSO 
DIAGNOSTICS 

BUGS 



3/15/72 FORK (ll) 



fork — spawn new process 

sys fork / fork = 2. 
(new process return) 
(old process return) 

fork is the only way new processes are created* 
The new process's core image is a copy of that of 
the caller of fork; the only distinction is the 
return location and the fact that rO in the old 
process contains the process ID of the new pro- 
cess* This process ID is used by wait* 

wait(ll), exec(ll) 

The error bit (c-bit) is set in the old process 
if a new process could not be created because of 
lack of process space* 

See wait(ll) for a subtile bug in process des- 
truction* 



FPE (II) 
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FPE (ll) 



NAME 

SYNOPSIS 

DESCRIPTION 



fpe — set floating exception handling 

sys fpe; arg / fpe = 40 • not in assembler 

This call allows one to catch traps resulting 
from floating point exceptions. Arg is a loca- 
tion within the program; floating exception traps 
are sent to that location. The normal effect of 
floating exception traps may be restored by giv- 
ing an arg equal to 0. 

To return after catching the fpe trap, execute 
the rti instruction. 



SEE ALSO 

DIAGNOSTICS 

BUGS 



The floating point exception (FEC) register is 
not saved per process. Examining this register 
for possible remedial action after a floating 
point exception trap is not guaranteed to work. 
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FSTAT (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



f Stat 



SEE ALSO 
DIAGNOSTICS 



get status of open file 



(file descriptor in rO) 
sys fstat; buf / fstat 



28. 



This call is identical to stat, except that it 
operates on open files instead of files given by 
name. It is most often used to get the status of 
the standard input and output files, whose names 
are unknown. 

stat(ll) 

The error bit (c-bit) is set if the file descrip- 
tor is unknown. 



BUGS 



GETUID (II) 

NAME 
SYNOPSIS 

DESCRIPTION 

SEE ALSO 
DIAGNOSTICS 



3/15/72 GETUID (ll) 



getuid — get user identification 

sys getuid / getuid = 24, 
(user ID in rO) 

getuid returns the real user ID of the current 
process. The real user ID identifies the person 
who is logged in, in contradistinction to the 
effective user ID, which determines his access 
permission at each moment. It is^thus useful^to 
programs which operate using the "set user Id" 
mode, to find out who invoiced them, 

setuid(Il) 



GTTY (II) 3/15/72 GTTY (ll) 



NAME gtty — • get typewriter status 

SYNOPSIS (file descriptor in rO) 

sys gtty; arg / gtty = 32. 
• • • 

arg: .=,+6 

DESCRIPTION gtty stores in the three words addressed by arg 

the status of the typewriter whose file descrip- 
tor is given in rO. The format is the same as 
that passed by sttv « 

SEE ALSO stty(ll) 

DIAGNOSTICS Error bit (c-bit) is set if the file descriptor 

does not refer to a typewriter. 



BUGS 
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ILGINS (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
DIAGNOSTICS 



ilgins — catch illegal instruction trap 
sys ilgins; arg / ilgins = 33. 

ilgins allows a program to catch illegal instruc- 
tion traps. If arg is zero, the normal instruc- 
tion trap handling is done: the process is ter- 
minated and a core image is produced. If arq is 
a location within the program, control is passed 
to arq when the trap occurs. 

This call is used to implement the floating point 
simulator, which catches and interprets 11/45 
floating point instructions. 

To return after catching the ilgins trap, execute 
the rti instruction. 

PDP-1 1 manual 
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INTR (ll) 



NAME 

SYNOPSIS 

DESCRIPTION 



intr — set interrupt handling 
sys intr; arg / intr = 27. 

When arg is 0, interrupts (ASCII DELETE) are 
ignored. When arg is 1 , interrupts cause their 
normal result, that is, force an exit . When arg 
is a location within the program, control is 
transferred to that location when an interrupt 
occurs. 

After an interrupt is caught, it is possible to 
resume execution by means of an rti instruction; 
however, great care must be exercised, since all 
l/O is terminated abruptly upon an interrupt. In 
particular, reads of the typewriter tend to re- 
turn with characters read, thus simulating an 
end of file. 



SEE ALSO quit(ll) 

DIAGNOSTICS 

BUGS — 



- 1 - 



6/12/72 



KILL (II) 



kill — destroy process 
(process number in rO) 

sys kill / kill = 37.; not in assembler 

kill destroys a process, given its process 
number* The process leaves a core image. 

This call is restricted to the super-user, and is 
intended only to kill an otherwise unstoppable 
process. 



c-bit set if user is not the super-user, or if 
process does not exist. 

Under strange circumstances, kill is ineffective. 
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LINK (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



link — link to a file 

sys link; name^ . namej / link = 9. 

A link to name, is created; the link has name 
name^. Either name may be an arbitrary path 
name. 



SEE ALSO link(l), unlink(ll) 

DIAGNOSTICS The error bit (c-bit) is set when name , cannot be 

found; when name, already exists; when the direc- 
tory of name cannot be written; when an attempt 
is made to link to a directory by a user other 
than the super-user; when an attempt is made to 
link to a file on another file system. 



BUGS 
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MAKDIR ( II ) 



NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
DIAGNOSTICS 



makdir — make a directory 

sys makdir; name; mode / makdir =14. 

makdir creates an empty directory whose name is 
the null -terminated string pointed to by name. 
The mode^oj the directory is mode . The special 
entries and are not present. 

makdir may be invoked only by the super-user. 

mkdir(l) 

Error bit (c-bit) is set if the directory already 
exists or if the user is not the super-user. 



BUGS 
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MDATE (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



mdate — set modified date on file 



(time to rO-rl ) 
sys mdate; file 



/ mdate = 30. 



File is the address of a null -terminated string 
giving the name of a file. The modified time of 
the file is set to the time given in the rO-r1 
registers . 

This call is allowed only to the super-user or to 
the owner of the file. 



SEE ALSO 

DIAGNOSTICS Error bit is set if the user is neither the owner 

nor the super-user or if the file cannot be 
found. 



BUGS 
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MOUNT (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
DIAGNOSTICS 



BUGS 



mount — mount file system 

sys mount; special; name / mount ss 21 . 

mount announces to the system that a removable 
file system has been mounted on special file 
special ; from now on, references to file name 
will refer to the root file on the newly mounted 
file system. Special and name are pointers to 
null-terminated strings containing the appropri- 
ate path names. 

Name must exist already. If it had contents, 
they are inaccessible while the file system is 
mounted. 

mount (I ), umount(ll) 

Error bit (c-bit) set if: special is 
inaccessible; name does not exist; special is 
already mounted; name is not on the RF; there are 
already four special files mounted. 

At most four removable devices can be mounted at 
a time. This call should be restricted to the 
super-used. 
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NICE (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 

DIAGNOSTICS 

BUGS 



nice — set program in low priority 
sys nice / nice ss 34. 

The currently executing process is set into the 
lowest priority execution queue. Background jobs 
that execute a very long time should do this. 
Once done, there is no way to restore a process 
to normal priority. 

formerly known as "hog" 



- 1 - 



OPEN (II) 



3/1 5/72 



OPEN (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



open — open for reading or writing 



SEE ALSO 
DIAGNOSTICS 



sys open; name; mode 
(descriptor in rO) 



/ open a 5 • 



open opens the file name for reading (if mode is 
0) or writing (if mode is non-zero), name is the 
address of a string of ASCII characters 
representing a path name, terminated by a null 
character. 

The file descriptor should be saved for subse- 
quent calls to read (or write) and close* 

In both the read and write case the file pointer 
is set to the beginning of the file* 

creat(ll), read(ll), write(ll), close(ll) 

The error bit (c-bit) is set if the file does not 
exist, if one of the necessary directories does 
not exist or is unreadable, if the file is not 
readable (resp. writable), or if 10 files are 
open. 



BUGS 
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PIPE (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



SEE ALSO 
DIAGNOSTICS 



pipe — • create a pipe 

sys pipe / pipe = 42.; not in assembler 

(file descriptor in rO) 

The pipe system call creates an l/o mechanism 
called a pipe. The file descriptor returned can 
be used in both read and write operations. When 
the pipe is written, the data is buffered up to 
504 bytes at which time the writing process is 
suspended. A read on the pipe will pick up the 
buffered data. 

It is assumed that after the pipe has been set 
up, two (or more) cooperating processes (created 
by subsequent fork calls) will pass data through 
the pipe with read and write calls. 

The shell has a syntax to set up a linear array 
of processes connected by pipes. 

Read calls on an empty pipe (no buffered data) 
with only one end (no synonymous file descriptors 
resulting from fork or dug) return an end-of- 
file, write calls under similar conditions are 
ignored. 

sh(l), read(ll), write(ll), fork(ll) 

The error bit (c-bit) is set if 10 files are 
already open. 



BUGS 
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QUIT (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 

DIAGNOSTICS 

BUGS 



quit — turn off quit signal 
sys quit; flag / quit a 26, 

When flacr is 0, this call disables quit signals 
from the typewriter (ASCII FS). When flag is 
non-zero, quits are re-enabled, and cause execu- 
tion to cease and a core image to be produced • 

Quits should be turned off only with due con- 
sideration. 

intr(ll) 



- 1 - 



READ (II) 



3/1 5/72 



READ (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



SEE ALSO 
DIAGNOSTICS 



read — read from file 

(file descriptor in rO) 
sys read; buffer; nbytes 
(nread in rO) 



/ read =3. 



A file descriptor is a word returned from a suc- 
cessful open or ere at call. 

Buffer is the location of nbytes contiguous bytes 
into which the input will be placed. It is not 
guaranteed that all nby te s bytes will be read; 
for example if the file refers to a typewriter at 
most one line will be returned. In any event the 
number of characters read is returned in rO. 

If rO returns with value 0, then end-of-file has 
been reached. 

open(ll), creat(ll) 

As mentioned, rO is on return when the end of 
the file has been reached. If the read was 
otherwise unsuccessful the error bit (c-bit) is 
set. Many conditions, can generate an error; 
physical i/o errors, bad buffer address, prepos- 
terous nbytes . file descriptor not that of an 
input file. 



BUGS 
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RELE (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



rele — release processor 

sys rele / rele s 0; not in assembler 

This call causes the process to be swapped out 
immediately if another process wants to run. Its 
main reason for being is internal to the system, 
namely to implement timer- runout swaps* However, 
it can be used beneficially by programs which 
wish to loop for some reason without consuming 
more processor time than necessary. 



SEE ALSO 

DIAGNOSTICS 

BUGS 
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SEEK (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



seek — move read/write pointer 

(file descriptor in rO) 

sys seek; offset; ptrname / seek = 19. 

The file descriptor refers to a file open for 
reading or writing. The read (resp. write) 
pointer for the file is set as follows: 

Ptrname is 0, the pointer is set to offset . 

if ptrname is 1, the pointer is set to its 
current location plus offset . 

Ptrname is 2, the pointer is set to the 
size of the file plus offset. 



SEE ALSO 
DIAGNOSTICS 

BUGS 



The error bit (c-bit) is set for an undefined 
file descriptor. 

A file can conceptually be as large as 2**20 
bytes. Clearly only 2**16 bytes can be addressed 
by seek . The problem is most acute on the large 
special files. 
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SETUID (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



SEE ALSO 

DIAGNOSTICS 

BUGS 



setuld — set process ID 

(process ID in rO) 

sys setuid / setuid =23, 

The user ID of the current process is set to the 
argument in rO, Both the effective and the real 
user ID are set. This call is only permitted to 
the super-user or if rO is the real user ID. 

getuid(ll) 

Error bit (c-bit) is set as indicated. 



SLEEP (II) 

NAME 
SYNOPSIS 

DESCRIPTION 

SEE ALSO 

DIAGNOSTICS 

BUGS 



9/4/72 SLEEP (ll) 



sleep — stop execution for interval 
(seconds in rO) 

sys sleep / sleep = 35.; not in assembler 

The current process is suspended from execution 
for the number of seconds specified by the con- 
tents of register 0. 



Due to the implementation, the sleep interval is 
only accurate to 256 60ths of a second (4.26 
sec). Even then, the process is placed on a low 
priority queue and must be scheduled. 



STAT (II) 



3/15/72 



STAT (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



Stat 



get file status 



SEE ALSO 
DIAGNOSTICS 



sys Stat; name; buf / stat « 18. 

name points to a null -terminated string naming a 
file; buf is the address of a 34(10) byte buffer 
into which information is placed concerning the 
file* It is unnecessary to have any permissions 
at all with respect to the file, but all direc- 
tories leading to the file must be readable. 

After Stat , buf has the following format: 



buf, +1 
+2, + 3 
+4 
+5 

+6, +7 
+8, +9 



i-number 

flags (see below) 
number of links 
user ID of owner 
size in bytes 

first indirect block or contents block 



+22, +2 3 eighth indirect block or contents block 

+24, +25 ,+26, +27 creation time 
+28, +29, +30, +31 modification time 
+32, +33 unused 

The flags are as follows s 

100000 used (always on) 

040000 directory 

020000 file has been modified (always on) 

010000 large file 

000040 set user ID 

000020 executable 

000010 read, owner 

000004 write, owner 

000002 read, non-owner 

000001 write, non-owner 

stat(l), f Stat (II) 

Error bit (c-bit) is set if the file cannot be 
found. 



BUGS 
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STIME (II) 



NAME 
SYNOPSIS 

DESCRIPTION 

SEE ALSO 
DIAGNOSTICS 



stime — set time 

(time in rO-rl ) 

sys stime / stime =25. 

stime sets the system's idea of the time and 
date. Only the super-user may use this call. 

dated ), time(ll) 

Error bit (c-bit) set if user is not the super- 
user. 



BUGS 
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STTY (II) 



NAME stty — set mcxae of typewriter 

SYNOPSIS (file descriptor in rO) 

sys stty; arg / stty = 31 . 
* • • 

arg: dcrsr; dctsr; mode 

DESCRIPTION stty sets mode bits for a typewriter whose file 

descriptor is passed in rO« First, the system 
delays until the typewriter is quiescent. Then, 
the argument dcrsr is placed into the typewri- 
ter's receiver control and status register, and 
dctsr is placed in the transmitter control and 
status register. The DC-1 1 manual must be con- 
sulted for the format of these words. For^the 
purpose of this call, the most important role of 
these arguments is to adjust to the speed of the 
typewriter. 

The mode argument contains several bits which 
determine the system's treatment of the 
typewriter: 

200 even parity allowed on input (e. g. for M37s) 

1 00 odd parity allowed on input 

040 raw mode: wake up on all characters 

020 map CR into LF; echo LF or CR as LF-CR 

010 echo (full duplex) 

004 map upper case to lower on input (e. g. M33) 

002 echo and print tabs as spaces 

001 inhibit all function delays (e. g. CRTs) 

Characters with the wrong parity, as determined 
by bits 200 and 100, are ignored. 

In raw mode, every character is passed back im- 
mediately to the program. No erase or kill pro- 
cessing is done; the end-of-file character (EOT), 
the interrupt character (DELETE) and the quit 
character (FS) are not treated specially. 

Mode 020 causes input carriage returns to be 
turned into new-lines; input of either CR or LF 
causes LF-CR both to be echoed (used for GE Ter- 
miNet 300 's and other terminals without the new- 
line function) . 

Additional bits in the high order byte of the 
mode argument are used to indicate that the ter- 
minal is an IBM 2741 and to specify 2741 modes. 
These mode bits are: 

400 terminal is an IBM 2741 
1000 the 2741 has the transmit interrupt feature 

(currently ignored) 
2000 use correspondence code conversion on output 
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4000 use correspondence code conversion on input 
(currently ignored) 

Normal input and output code conversion for 2741s 
is EBCDIC (e. g. 963 ball and corresponding key- 
board). The presence of the transmit interrupt 
feature permits the system to do read-ahead while 
no output is in progress. In 2741 mode, the low 
order bits 331 are ignored. 



SEE ALSO 



sttyd), gtty(ll) 



DIAGNOSTICS 



The error bit (c-bit) is set if the file descrip- 
tor does not refer to a typewriter. 



BUGS 



This call should be used with care. 
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SYNC (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



sync — update super-block 

sys sync / sync » 36«; not in assembler 

sync causes the super block for all file systems 
to be written out. It is only necessary on sys- 
tems in which this writing may be delayed for a 
long time, i.e,, those which incorporate hardware 
protection facilities. 

It should be used by programs which examine a 
file system, for example check, df, tm, etc. 



SEE ALSO 

DIAGNOSTICS 

BUGS 
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TIME (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



SEE ALSO 

DIAGNOSTICS 

BUGS 



time — get time of year 

sys time / time = 13, 
(time rO-r1 ) 

time returns the time since 00:00:00, Jan. 1, 
1972, measured in sixtieths of a second. The 
high order word is in the rO register and the low 
order is in the r1 . 

dated ), mdate(ll) 



The time is stored in 32 bits. This guarantees a 
crisis every 2.26 years. 
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TIMES (II) 



NAME times — get process times 

SYNOPSIS sys times; buffer / times = 43.; not in assemble 

buffer: !=I+[24.*3] 

DESCRIPTION times returns time-accounting information for the 

system as a whole, for the current process, and 
for the terminated child processes of the current 
process. All the times are 2-word (32-bit) 
numbers, and the unit of measurement is 1/60 
second. 

After the call, the buffer will appear as 
follows 

buffer: 
system: 



proces 



child: 

.=.+24. 

The format of the "child" times is the same as 
that for the process tiroes; the numbers are the 
sum of the times for all terminated direct or 
indirect descendants of the current process. 

The "absolute" time returned is the same as that 
given by time(ll). The "total system times" are 
times since the last cold boot. 

FILES 

SEE ALSO time(ll), timed ) 

DIAGNOSTICS — 



.=.+4 / absolute time 

.=.+4 / total system time 

.=.+4 / total swap time 

.=.+4 / other l/o wait time 

.a. +4 / idle time 

.=.+4 / total user time 

• 
• 

•=.+4 / (ignore) 

.=.+4 / time in system 

•=.+4 / (ignore) 

.=.+4 / I/O wait time 

.=.+4 / (ignore) 

.SS.+4 / processor time 



BUGS 
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UMOUNT (II) 



NAME 

SYNOPSIS 
DESCRIPTION 



SEE ALSO 
DIAGNOSTICS 



umount — dismount file system 
sys umount; special / umount = 22. 

umount announces to the system that special file 
special is no longer to contain a removable file 
system. The file associated with the special 
file reverts to its ordinary interpretation (see 
mount ) . 

The user must take care that all activity on the 
file system has ceased. 

umount ( I ) , mount ( II ) 

Error bit (c-bit) set if no file system was 
mounted on the special file. 



BUGS 



Use of this call should be restricted to the 
super-user. 
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NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
DIAGNOSTICS 



unlink — remove directory entry 

sys unlink; name / unlink = 10. 

Name points to a null -terminated string. Unlink 
removes the entry for the file pointed to by name 
from its directory. If this entry was the last 
link to the file, the contents of the file are 
freed and the file is destroyed, if, however, 
the file was open in any process, the actual des- 
truction is delayed until it is closed, even 
though the directory entry has disappeared. 

rm(l), rmdir(l), link(ll) 

The error bit (c-bit) is set to indicate that the 
file does not exist or that its directory cannot 
be written. Write permission is not required on 
the file itself. It is also illegal to unlink a 
directory (except for the super-user). 



BUGS 
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NAME 
SYNOPSIS 

DESCRIPTION 



wait — wait for process to die 

sys wait / wait = 7. 
(process ID in rO) 

(termination status/user status in r1 ) 

wait causes its caller to delay until one of its 
child processes terminates. If any child has 
died since the last wait , return is immediate; if 
there are no children, return is immediate with 
the error bit set. in the case of several chil- 
dren several wait s are needed to learn of all the 
deaths. 

If the error bit is not set on return, the r1 
high byte contains the low byte of the child pro- 
cess rO when it terminated. The r1 low byte con- 
tains the termination status of the process from 
the following list: 






exit 


1 


bus error 


2 


illegal instruction 


3 


trace trap 


4 


lOT trap 


5 


power fail trap 


6 


EMT trap 


7 


bad system call 


8 


PIR interrupt 


9 


floating point exception 


10 


memory violation 


11 


quit 


12 


interrupt 


13 


kill (see kill(ll)) 


14 


User I/O (not currently possible) 


+16 


core image produced 



SEE ALSO exit (II), fork(ll) 

DIAGNOSTICS error bit (c-bit) on if no children not previous- 
ly waited for. 

BUGS A child which dies, but is never waited for con- 

sumes a slot in the process table. When this 
table is full, the system is effectively hung. 
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NAME 
SYNOPSIS 

DESCRIPTION 



SEE ALSO 
DIAGNOSTICS 



write — write on file 

(file descriptor in rO) 
sys write; buffer; nbytes 
(number written in rO) 



/ write ss 4. 



A file descriptor is a word returned from a suc- 
cessful open or ere at call, 

buffer is the address of nbytes contiguous bytes 
which are written on the output file. The number 
of characters actually written is returned in rO. 
It should be regarded as an error if this is not 
the same as requested. 

Writes which are multiples of 512 characters long 
and begin on a 512-byte boundary are more effi- 
cient than any others. 

creat(ll), open(ll) 

The error bit (c-bit) is set on an error: bad 
descriptor, buffer address, or count; physical 
l/o errors. 



BUGS 
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ATAN, ATAN2 (ill) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



atan — arc tangent function 
jsr r5,atan[2] 

The atan entry returns the arc tangent of frO in 
frO, The range is -it/2 to 7r/2« 

The atan2 entry returns the arc tangent of 
frO/fr1 in frO. The range is to it • 

kept in /lib/liba.a 



there is no error return 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



atof — ascii to floating 
jsr r 5, atof; subr 

atof will convert an ascll stream to a floating 
number returned in frO. 

The subroutine subr (supplied by the caller) is 
called on r5 for each character of the ascii 
stream, subr should return the character in rO. 
The first character not used in the conversion is 
left in rO. 

The only numbers recognized are: an optional 
minus sign followed by a string of digits option- 
ally containing one decimal^point , then followed 
optionally by the letter "e" followed by a signed 
integer. 

The subroutine subr must not disturb any regis- 
ters. 

kept in /lib/liba.a 
Calls atoi (ill) 

There are none; overflow results in a very large 
number and garbage characters terminate the scan. 

The routine should accept initial initial 
blanks, and "e" for "e". 



Overflow should be signalled with the carry bit. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



atoi — ascii to integer 
jsr r5,atoi; subr 

atoi will convert an ascii stream to a binary 
number returned in r1 . 

The subroutine subr (supplied by the caller) is 
called on r5 for each character of the ascii 
stream, subr should return the character in rO. 
The first character not used in the conversion is 
left in rO. 

The numbers recognized are: an optional minus 
sign followed by a string of digits • 

The subroutine subr must not disturb any regis- 
ters. 

kept in /lib/liba.a 



There are none; the routine charges on regardless 
of consequences; see BUGS. 

It pays no attention to overflow - you get what- 
ever the machine instructions mul and div happen 
to leave in the low order half - in fact, the 
carry bit should be set and isn't. 



The routine should accept initial + and initial 
blanks. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



compar — default comparison routine for qsort 
jsr pc,compar 

Compar is the default comparison routine called 
by qsort and is separated out so that the user 
can supply his own comparison. 

The routine is called with the width (in bytes) 
of an element in r3 and it compares byte-by-byte 
the element pointed to by rO with the element 
pointed to by r4. 

Return is via the condition codes, which are 
tested by the instructions "bit" and "bgt". That 
is, in the absence of overflow, then the condi- 
tion (rO) < (r4) should leave the Z-bit off and 
N-bit on while (rO) > (r4) should leave Z and N 
off. Still another way of putting it is that 
for elements of length 1 the instruction 

cmpb ( r ) , ( r4 ) 

suffices. 

Only rO is changed by the call, 
kept in /lib/liba.a 
qsort (III) 

It could be receded to run faster. 
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NAME 
SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



crypt — password encoding 

mov $lcey,rO 
jsr pc, crypt 

On entry, rO should point to a string of charac- 
ters terminated by an ASCII NULL, The routine 
performs an operation on the key which is diffi- 
cult to invert (i.e. encrypts it) and leaves the 
resulting eight bytes of^ASCII alphanumerics in a 
global cell called "word". 

Login uses this result as a password. 

kept in /lib/liba.a 

passwdCl ) ,passwd(v) , login(l) 

there are none; garbage is accepted. 



- 1 - 



CTIME (III) 



1/15/73 



CTIME (III) 



NAME 
SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



ctime 

sys 
raov 
jsr 



— convert date and time to ASCII 
time 

$buffer,r2 
pc, ctime 



The output buffer is 1 6 characters long and the 
time has the format 

Oct 9 17:32:24\0 

The input time must be in the rO and r1 registers 
in the form returned by svs time. 

kept in /lib/liba.a 

ptime(lll), time (II) 



The routine must be reassembled for leap year. 
Dec 31 is followed by Dec 32 and so on* 
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DDSPUT, DDSINIT (ill) 



ddsput — put a character on display data set 

(file descriptor in rO) 
jsr pc,ddsinit 

(character in rO) 
Jsr pc, ddsput 

DESCRIPTION These, routines provide an interface to the 

Display Data Set, a peculiar device which can be 
called by Picturephone sets and which will 
display some of the ASCII character set and cer- 
tain other graphics on the Picturephone screen* 

If the DC11 or other interface hardware is not 
already set up to talk to the Display Data Set, 
the ddsinit entry should be called with the ap- 
propriate file descriptor in rO« On the only 
known DDS attached to UNIX, the associated spe- 
cial file is called "/dev/ttyc**. ddsinit also 
clears the display. 

Thereafter, characters may be displayed by cal- 
ling ddsput « To the extent possible, ddsput 
simulates an ordinary terminal* Characters fal- 
ling to the right of the 22X22 screen area are 
ignored; the 23rd line on the screen causes the 
screen to be erased and that line to be put at 
the top of the new display* Certain ASCII char- 
acters are interpreted specially as follows: 

clear screen, go to top left 
expand to right number of spaces 
treat as reverse line feed (move n) 
move cursor 1 place right (move e) 
forward line feed (move s) 
backspace 1 position (move w) 
enter graph mode 
leave graph mode 

put cursor at start of current line 

Graph mode allows display of the non-ASCII char- 
acters and will be described when hell freezes 
over* 

Lower-case ASCII alphabetics are mapped into 
upper case* Several ASCII non-alphabetic graph- 
ics are unavailable as well* Also the lower 
right circle of the character is missing* 
Also one of the circuit cards in the DDS has a 
crack in it and sometimes it doesn't work. All 
in all, it is best to avoid this device* 

FILES kept in /lib/liba*a 

SEE ALSO AT&T writeup on DDS 



NAME 
SYNOPSIS 



FF 

HT 

DC1 

DC2 

DC 3 

DC4 

SO 

SI 

CR 
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NAME 
SYNOPSIS 



DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



ecvt, fcvt — output conversion 

jsr pc,ecvt 

or 

jsr pc,fcvt 

Ecvt is called with a floating point number in 
fro. 

On exit, the number has been converted into a 
string of ascii digits in a buffer pointed to by 
rO. The number of dic[its produced is controlled 
by a global variable ^ndigits". 

Moreover, the position of the decimal point is 
contained in r2: r2aO means the d.p, is at the 
left hand end of the string of digits; r2>0 means 
the d,p. is within or to the right of the string. 

The sign of the number is indicated by r1 (0 for 
+; 1 for -) . 

The low order digit has suffered decimal rounding 
(i. e. may have been carried into). 

Fcvt is identical to ecvt, except that the 
correct digit has had decimal rounding for F- 
style output of the number of digits specified by 
"^ndigits • 

kept in /lib/liba.a 

ftoa(ill) 
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EXP (III) 



NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 



exp • — exponential function 
jsr r5,exp 

The exponential of frO is returned in frO. 
kept in /lib/liba.a 



If the result is not represent able, the c-bit is 
set and the largest positive number is returned. 

Zero is returned if the result would underflow. 



BUGS 



FTOA (III) 



1/1 5/73 



FTOA (III) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



ftoa — floating to ascll conversion 
jsr r5,ftoa; subr 

ftoa will convert the floating point number in 
frO into ascii in the form 

[-]ddddd.dd* 

if possible, otherwise in the form 

[-] d .dddddddde [-] dd* . 

For each character generated by ftoa, the 
subroutine subr (supplied by the caller) is 
called on register r5 with the character in rO. 

The number of ^digits can be changed by changing 
the value of "^ndigits" in ecvt (default is 10«). 

The subroutine subr must not disturb any regis- 
ters. 

kept in /lib/liba.a 
ecvt (III), itoa(IIl) 
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FTOO (ill) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



ftoo — floating to octal conversion 
jsr r 5, ftoo; subr 

ftoo wil convert the floating point number in frO 
into ascii in the conventional octal form 

000000 ; 000000 ; 000000 ; 000000 

For each character generated by ftoo, the 
subroutine subr (supplied by the caller) is 
called on register r5 with the character in rO, 

The subroutine subr must not disturb any regis- 
ters • 

kept in /lib/liba.a 
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CONNECT, GERTS (ill) 



NAME 
SYNOPSIS 



connect, gerts — Gerts communication over 201 

Jsr r5, connect 
(error return) 



Jsr r5, gerts; fc; oc; ibuf; otouf 
(error return) 



DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



Other entry points: gcset, gout 

The GCOS GERTS interface is so bad that a 
description here is inappropriate. Anyone need- 
ing to use this interface should seek divine gui- 
dance* 

/dev/dnO , /dev/dpO 
kept in /lib/liba.a 

dn(lV), dp(iv), HIS documentation 
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GETC, GETW, FOPEN (ill) 



NAME 
SYNOPSIS 



DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



getw, getc, fopen — buffered input 

mov $f ilehame,rO 
Jsr r5, fopen; iobuf 

jsr r5,getc; iobuf 
(character in rO) 

jsr r5,getw; iobuf 

(word in rO) 

These routines are used to provide a buffered 
input facility, iobuf is the address of a 
518(10) byte buffer area whose contents are main- 
tained by these routines. Its format is: 



ioptr: .=.+2 
.= •+2 
• = .+2 
.=.+512. 



/ file descriptor 
/ characters left in buffer 
/ ptr to next character 
/ the buffer 



fopen may be called initially to open the file. 
On return, the error bit (c-bit) is set if the 
open failed. If fopen is never called, get will 
read from the standard input file. 

qetc returns the next byte from the file in rO. 
The error bit is set on end of file or a read 
error. 

cretw returns the next word in rO. getc and getw 
may be used alternately; there are no odd/even 
problems. 

iobuf must be provided by the user; it must be on 
a word boundary. 

To reuse the same buffer for another file, it is 
sufficient to close the original file and call 
fopen again. 

kept in /lib/liba.a 

open(ll), read (II), putc(lll) 

c-bit set on EOF or error 
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NAME 
SYNOPSIS 



hypot — calculate hypotenuse 



DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



movf 
movf 
jsr 
movf 



a, frO 

b, fr1 

r5 , hypot 
frO,.., 



The square root of frO*frO + f r1 ♦f r1 is returned 
in frO, The calculation is done in such a way 
that overflow will not occur unless the answer is 
not representable in floating point. 

kept in /lib/liba.a 

sqrt(lll) 

The c-bit is set if the result cannot be 
represented. 



BUGS 
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ITOA (III) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



Itoa — integer to ascii conversion 



jsr 



r 5, itoa; subr 



itoa will convert the number in rO into ascii 
decimal preceded by a - sign if appropriate. For 
each character generated by itoa, the subroutine 
subr (supplied by the caller) is called on regis- 
ter r5 with the character in rO. 

The subroutine subr must not disturb any regis- 
ters • 

kept in /lib/liba.a 
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LOG (III) 



NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 



log — logarithm (base e) 
jsr r5,log 

The logarithm (base e) of frO is returned in frO. 
kept in /lib/liba.a 



The error bit (c-bit) is set if the input argu- 
ment is less than or equal to zero and the result 
is set to the largest negative number. 



BUGS 
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MESG (III) 



NAME 

SYNOPSIS 

DESCRIPTION 

FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



mesg — write message on typewriter 

jsr r5,mesg; <Now is the time\0>; .even 

mesg writes the string immediately following its 
call onto the standard output file. The string 
must be terminated by an ASCII NULL byte. 

kept in /lib/liba.a 
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NAME nlist — get entries from name list 

SYNOPSIS jsr r5, nlist; file; list 

. * * * 

file: <file name\0>; .even 
list: 

<name1xxx>; typel ; valuel 
<name2xxx>; type 2; value2 
• • • 





DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



nlist will examine the name list in the given 
assembler output file and selectively extract a 
list of values* The name list consists of a list 
of 8-character names (null padded) each followed 
by two words. The list is terminated with a 
zero. Each name is looked up in the name list of 
the file. If the name is found, the type and 
value of the name are placed in the two words 
following the name. If the name is not found, 
the type entry is set to -1 • 

This subroutine is useful for examining the sys- 
tem name list kept in the file /sys/sys/unix. In 
this way programs can obtain system 'magic' 
numbers that are up to date. 

kept in yiib/liba.a 

a.out(v) 

All type entries are set to -1 if the file cannot 
be found or if it is not a valid namelist. 



BUGS 
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NAME 
SYNOPSIS 



DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



pow — floating exponentiation x y 

movf x,frO 
movf y,fr1 
jsr pc,pow 
movf f r 

The value of x'^y (i.e. x^) is returned in frO. 
o'^x returns zero for all x. 

(-x)^y returns a result only if y is an integer, 
kept in /lib/liba.a 
exp(lll), log(iri) 

The carry bit is set on return in case of over- 
flow or in case of 0^0 or (-x)'^y for y non- 
integer. 



BUGS 
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NAME 
SYNOPSIS 

DESCRIPTION 



ptime — print date and time 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



sys 
mov 
jsr 



time 
file,r2 
pc, ptime 



ptime prints the date and time in the form 

Oct 9 17:20:33 

on the file whose file descriptor is in r2. The 
string is 15 characters long. The time to be 
printed must be placed in the rO and r1 registers 
in the form returned by sys time. 

kept in /lib/liba.a 

time (II ), ctime(lll) (used to do the conversion) 
see ctime 
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NAME 
SYNOPSIS 



DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



putc, putw, fcreat, flush — buffered output 

mov $f ilename,rO 

jsr r5,fcreat; iobuf 

(get byte in rO) 

jsr r5,putc; iobuf 

(get word in rO) 

jsr r5,putw; iobuf 



jsr 



r 5, flush; iobuf 



fcreat creates the given file (mode 17) and sets 
up the buffer iobuf (size 518(10) bytes); putc 
and putw write a byte or word respectively onto 
the file; flush forces the contents of the buffer 
to be written, but does not close the file* The 
format of the buffer is: 



iobuf 5 



.= •+2 
.= .+2 
• = .+2 
.=.+512. 



/ file descriptor 
/ characters unused in buffer 
/ ptr to next fr«e character 
/ buffer 



fcreat sets the error bit (c-bit) if the file 
creation failed; none of the other routines re- 
turn error information. 

Before teminating, a program should call flush 
to force out the last of the output. 

The user must supply iobuf, which should begin on 
a word boundary. 

To write a new file using the same buffer, it 
suffices to call flush , close the file, and call 
fcreat again. 

kept in /lib/liba.a 

creat(ll), write(ll), getc(lll) 

error bit possible on fcreat call 
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NAME 
SYNOPSIS 



DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



qsort — quicker sort 

(base of data in r1 ) 
(end+1 of data in r2) 
(element width in r3) 
jsr pc, qsort 

qsort is an implementation of the quicker sort 
algorithm. It is designed to sort equal length 
elements. Registers r1 and r2 delimit the region 
of core containing the array of byte strings to 
be sorted: r1 points to the start of the first 
string, r2 to the first location above the last 
string. Register r3 contains the length of each 
string. r2-r1 should be a multiple of r3. On 
return, rO, r1 , r2, rS, r4 are destroyed. 

The routine coropar (q.v.) is called to compare 
elements and may be replaced by the user. 

kept in /lib/liba.a 

compar(lll) 



It scribbles on r4. 
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NAME 
SYNOPSIS 

DESCRIPTION 



rand — random number generator 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

WARNING 



jsr pc,srand 
Jsr pc,rand 



/to initialize 

/to get a random number 



The routine uses a multiplicative congruential 
random number generator to return successive 
pseudo-random numbers in rO in the range from 1 
to 2"l 5-1 . 

The generator is reinitiali2:ed by calling srand 
with 1 in rO. 

It can be set to a random starting point by cal- 
ling srand with whatever you like in rO, for 
example the result left in r1 from svs time. 

kept in /lib/liba.a 



The author of this routine has been writing 
random-number generators for many years and has 
never been known to write one that worked* 
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NAME salloc — string manipulation routines 

SYNOPSIS (get size in rO) 

jsr pc, allocate 

(get source pointer in rO. 
destination pointer in r1 ) 
jsr pc,copy 

jsr pc,wc 

(all following instructions assume r1 contains pointer) 

jsr pc, release 

(get character in rO) 
jsr pc,putchar 

sr pCjlooJcchar 
character in rO) 

jsr pc,getchar 
(character in rO) 

(get character in rO) 
jsr pc,alterchar 

(get position in rO) 
jsr pCySeekchar 

jsr pc, backspace 
(character in rO) 

(get word in rO) 
jsr pc,putword 

jsr pc,lookword 
(word in rO) 

jsr pc,Qetword 
(word in rO) 

(get word in rO) 
jsr pc,alterword 

sr pc, backword 
word in rO) 

jsr pc, length 
(length in rO) 

sr pc, position 
position in rO) 

jsr pc, rewind 
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jsr pc, create 
jsr pc,fsfile 
Jsr pcjzero 

DESCRIPTION This package is a complete set of routines for 

dealing with almost arbitrary length strings of 
words and bytes. The strings are stored on a 
disk file, so the sum of their lengths can be 
considerably larger than the available core. 

For each string there is a header of four words, 
namely a write pointer, a read pointer and 
pointers to the beginning and end of the block 
containing the string. Initially the read and 
write pointers point to the beginning of the 
string. All routines that refer to a string 
require the header address in r1 . Unless the 
string is destroyed by the call, upon return r1 
will point to the same string, although the 
string may have grown to the extent that it had 
to be be moved. 

allocate obtains a string of the requested size 
and returns a pointer to its header in r1 . 

release releases a string back to free storage. 

putchar and putword write a byte or word respec- 
tively into the string and advance the write 
pointer. 

lookchar and lookword read a byte or word respec- 
tively from the string but do not advance the 
read pointer. 

qetchar and getword read a byte or word respec- 
tively from the string and advance the read 
pointer. 

alterchar and alterword write a byte or word 
respectively into the string where the read 
pointer is pointing and advance the read pointer. 

backspace and backword read the last byte or word 
written and decrement the write pointer. 

All write operations will automatically get a 
larger block if the current block is exceeded. 
All read operations return with the error bit set 
if attempting to read beyond the write pointer. 

seekchar moves the read pointer ta^^he offset 
specified in rO. 
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length returns the current length of the string 
(beginning pointer to write pointer) in rO. 

position returns the current offset of the read 
pointer in rO. 

rewind moves the read pointer to the beginning of 
the string. 

create returns the read and write pointers to the 
beginning of the string. 

f sf ile rooves the read pointer to the current 
position of the write pointer. 

zero zeros the whole string and sets the write 
pointer to the beginning of the string. 

copy copies the string whose header pointer is in 
rO to the string whose header pointer is in r1 . 
Care should be taken in using the copy instruc- 
tion since r1 will be changed if the contents of 
the source string is bigger than the destination 
string. 

wc forces the contents of the internal buffers 
and the header blocks to be written on disc. 

FILES The allocator is in /lib/libs .a; the ^ option to 

Id will link edit references to the allocator. 

alloc .d is the temporary file used to contain the 
strings. 

SEE ALSO — 

DIAGNOSTICS "error in copy" if a disk write error occurs dur- 

ing the execution of the copy instruction, 
"error in allocator" if any routine is called 
with^a bad header pointer, "cannot open output 
file" if file alloc .d cannot be created or 
opened, "out of space" if there's no available 
block of the requested size or no headers avail- 
able for a new block. 

BUGS 
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SIN, COS (III) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



sin, cos — sine cosine 
jsr r5,sin (cos) 

The sine (cosine) of frO in radians is returned 
in frO. 

The magnitude of the argument should be checked 
by the caller to make sure the result is meaning- 
ful. 

kept in /lib/liba.a 



there are none 
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SQRT (III) 



NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 



sqrt — square root function 
jsr r5,sqrt 

The square root of frO is returned in frO. 
kept in /lib/liba.a 



The c-bit is set on negative arguments and is 
returned . 



BUGS 
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NAME 



SYNOPSIS 



switch — switch on value 

(switch value in rO) 
jsr r5,8witchj swtab 
(not-found return) 



swtab: val1 ; labi ; 
• • • 

vain; labn 




DESCRIPTION 



FILES 



SEE ALSO 



switch compares the value of rO against each of 
the val.. if a match is found, control is 
transferred to the corresponding lab. (aftey- pop- 
ping the stack once)* If no match has been found 
by the time a null lab^ occurs, switch returns. 

kept in /lib/liba.a 



DIAGNOSTICS 



BUGS 
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TTYN (III) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



ttyn — return name of current tty 
jsr pc,ttyn 

The routine hunts up the name of the input tty 
attached to the process (one byte from the set 
{01 2345678abc} at present) and returns it in rO. 

"x** is returned if no genuine input tty is at- 
tached to the process • 

kept in /lib/liba.a 

fstat(ll) 
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NAME dc — DC-11 communications interfaces 

DESCRIPTION 

The special files /dev/ttyO, /dev/tty1 , ... refer to the 
DC11 asynchronous communications interfaces. At the 
moment there are ten of them, but the number is subject 
to change. 

When one of these files is opened, it causes the process 
to wait until a connection is established, (in practice, 
however, user's programs seldom open these files; they 
are opened by init and become a user's standard input and 
output file.) The very first typewriter file open in a 
process becomes the control typewriter for that process. 
The control typewriter plays a special role in handling 
quit or interrupt signals, as discussed below. The con- 
trol typewriter is inherited by a child process during a 
fork . 

A terminal associated with one of these files ordinarily 
operates in full-duplex mode. Characters may be typed at 
any time, even while output is occurring, and are only 
lost when the system's character input buffers become 
completely choked, which is rare, or when the user has 
accumulated the maximum allowed number of input charac- 
ters which have not yet been read by some program. 
Currently this limit is 150 characters. When this is 
happening the character is echoed for every lost 
input character. 

When first opened, the interface mode is ASCII 
characters; 150 baud; even parity only accepted; 10 
bits /character (one stop bit); and newline action charac- 
ter. The system delays transmission after sending cer- 
tain function characters. Delays for horizontal tab, 
newline, and form feed are calculated for the Teletype 
Model 37; the delay for carriage return is calculated for 
the GE TermiNet 300. Most of these operating states can 
be changed by using the system call sttydl). In partic- 
ular the following hardware states are program settable 
independently for input and output (see DC1 1 manual): 
134.5, 150, 300, or 1200 baud; one or two stop bits on 
output; and 5, 6, 7, or 8 data bits/character. In addi- 
tion, the following software modes can be invoked: accep- 
tance of even parity, odd parity, or both; a raw mode in 
which all characters may be read one at a time; a car- 
riage return (CR) mode in which CR is mapped into newline 
on input and either CR or line feed (LF) cause echoing of 
the sequence LF-CR; mapping of upper case letters into 
lower case; suppression of echoing; suppression of delays 
after function characters; the printing of tabs as 
spaces; and setting the system to handle IBM 2741s. See 
getty(VIl) for the way that terminal speed and type are 
detected. 

Normally, typewriter input is processed in units of 
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lines* This means that a program attempting to read will 
be suspended until an entire line has been typed. Also, 
no matter how many characters are requested in the read 
call/ at most .one line will be returned, it is not 
however necessary to read a whole line at once; any 
number of characters may be requested in a read, even 
one, without losing information. 

During input, erase and kill processing is normally done. 
The character erases the last character typed, except 
that it will not erase beyond the beginning of a line or 
an EOT. The character "© kills the entire line up to 
the point where it was typed, but not beyond an EOT. 
Both these characters operate on a keystroke basis in- 
dependently of any backspacing or tabbing that may have 
been done. Either or may be entered literally by 
preceding it by "X"; the erase or kill character remains, 
but the X" disappears. 

It is possible to use raw mode in which the program read- 
ing is awakened on each character. In< raw mode, no erase 
or kill processing is done; and the EOT, quit and inter- 
rupt characters are not treated specially. 

The ASCII EOT character may be used to generate an end of 
file from a typewriter. When an EOT is received, all the 
characters waiting to be read are immediately passed to 
the program, without waiting for a new-line. Thus if 
there are no characters waiting, which is to say the EOT 
occurred at the beginning of a line, zero characters will 
be passed back, and this is the standard end -of-file sig- 
nal. The EOT is not passed on except in raw mode. 

When the carrier signal from the dataset drops (usually 
because the user has hung up his terminal) any read re- 
turns with an end-of-file indication. Thus programs 
which read a typewriter and test for end-of-file on their 
input can terminate appropriately when hung up on. 

Two characters have a special meaning when tyged. The 
ASCII DEL character (sometimes called "rubout ) is the 
interrupt signal. When this character is received from a 
given typewriter, a search is made for all processes 
which have this typewriter as their control typewriter, 
and which have not informed the system that they wish to 
ignore interrupts. If there is more than one such pro- 
cess, one of these is selected, for practical purposes at 
random. The process is either forced to exit or a trap 
is simulated to an agreed-upon location in the process. 
See intr(ll) . 

The ASCII character FS is the quit signal, its treatment 
is identical to the interrupt signal except that unless 
the receiving process has made other arrangements it will 
not only be terminated but a core image file will be gen- 
erated. See quit(ll). The character is not passed on 
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except in raw mode. 

Output is prosaic compared to input. When one or more 
characters are written, they are actually transmitted to 
the terminal as soon as previously-written characters 
have finished typing. Input characters are echoed by 
putting them in the output queue as they arrive. When a 
process produces characters more rapidly than they can be 
typed, it will be suspended when its output queue exceeds 
some limit. When the queue has drained down to some 
threshold the program is resumed. Even-parity is always 
generated on output. The EOT character is not transmit- 
ted to prevent terminals which respond to it from being 
hung up. 

The system will handle IBM 2741 terminals. See 
getty(VIl) for the way that 2741s are detected. In 2741 
mode, the hardware state is: 134,5 baud; one output stop 
bit; and 7 bits/character. Because the 2741 is inherent- 
ly half-duplex, input is not echoed. Proper function 
delays are provided. For 2741s without a feature known 
as "transmit interrupt** it is not possible to collect 
input ahead of the time that a program reads the type- 
writer, because once the keyboard has been enabled there 
is no way to send further output to the 2741, It is 
currently assumed that the feature is absent; thus the 
keyboard is unlocked only when some program reads. The 
interrupt signal (normally ASCII DEL) is simulated when 
the 2741 **attention'' key is pushed to generate either a 
2741 style EOT or a break. It is not possible to gen- 
erate anything corresponding to the end-of-file EOT or 
the quit signal. Currently IBM EBCDIC is default for 
input and output; correspondence code output is settable 
(see stty(l2)« S^® ^S^^ ASCII character set is not 
available: [", **]**, **{", gre missing on inpyt 

and are printed as blank on output; 4: is used for \ ; 
-» for for both and on output; and » 

maps into " " on input. Similar mappings occur with 
correspondence code output. 



FILES 



/dev/tty [01 234567 ab] 

/dev/ttyc 

/ dev/ ttyd 



1 1 3B dataphones 
display data set 
113B with /dev/dnl 



SEE ALSO 



kl(lV), getty(VIl) 



BUGS 



The primarily Model 37 oriented delays may not be 
appropriate for all other ASCII terminals. 
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NAME dn — dn-1 1 ACU interface 

DESCRIPTION dn? is a write-only file. Bytes written on dn? 

must be ASCII as follows: 

0-9 dial 0-9 

: dial ♦ 

; dial # 

= end-of-number 

The entire telephone number must be presented in 
a single write system call. 

It is recommended that an end-of-number code be 
given even though only one of the ACU's (113C) 
actually requires it. 

FILES /dev/dnO connected to 801 with dpO 

/dev/dnl connected to 1 1 3C with ttyd 

/dev/dn2 not currently connected 

SEE ALSO dp(lV), dc(iv), write(ll) 



BUGS 



- 1 - 



DP (IV) 



3/1 5/72 



DP (IV) 



NAME dp — ■ dp-1 1 201 data-phone interface 

DESCRIPTION dp? Is a 201 data -phone interface file, read and 

write calls to dp? are limited to a maximum of 
400 bytes. Each write call is sent as a single 
record. Seven bits from each byte are written 
along with an eighth odd parity bit. The sync 
must be user supplied. Each read call returns 
characters received from a single record. Seven 
bits are returned unaltered; the eighth bit is 
set if the byte was not received in odd parity. 
A 20 second time out is set and a zero byte 
record is returned if nothing is received in that 
time. 

FILES /dev/dpO 201 dataphone used to call GCOS 

SEE ALSO dn(iv), gerts(lll) 

BUGS The dg file is GCOS oriented. It should be more 

flexible. 
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NAME 

DESCRIPTION 



FILES 

SEE ALSO 
BUGS 



kl — KL-11/TTY-33 console typewriter 

ttv (as distinct from tty? ) refers to the console 
typewriter hard-wired to the PDP-11 via a KL-11 
interface. 

Generally, the disciplines involved in dealing 
with tty are similar to those for tty? and sec- 
tion dc(iv) should be consulted. The following 
differences are salient: 

The system calls stty and qtty do not apply to 
this device. It cannot be placed in raw mode; on 
input, upper case letters are always mapped into 
lower case letters; a carriage return is echoed 
when a line -feed is typed. 

The quit character is not FS (as with ttv? ) but 
is generated by the key labelled "alt mode." 

By appropriate console switch settings, it is 
possible to cause UNIX to come up as a single- 
user system with l/o on this device. 

/dev/tty 

/dev/ttyS synonym for /dev/tty 

dc(iv), init(VIl) 



- 1 - 



MEM (IV) 



3/1 5/72 



MEM (IV) 



NAME 

DESCRIPTION 



FILES 
SEE ALSO 
BUGS 



mem — core memory 

mem is a special file that is an image of the 
core memory of the computer. It may be used, for 
example, to examine, and even to patch the system 
using the debugger. 

Mem is a byte-oriented file; its bytes are num- 
bered to 65,5 35. 

If a non-existent memory location is referenced, 
the user suffers the resultant bus error. 

Memory referenced through the file is treated 
with movb instructions. Certain device registers 
do not implement DATOB cycles to odd addresses. 
Other registers react strangely to this address- 
ing. 

/ dev/mem 
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NAME 

DESCRIPTION 



FILES 
SEE ALSO 
BUGS 



pc — PC-11 paper tape reader/punch 

ppt refers to the PC-11 paper tape reader or 
punch, depending on whether it is read or writ- 
ten. 

When ppt is opened for writing, a 1 00-character 
leader is punched. Thereafter each byte written 
is punched on the tape. No editing of the char- 
acters is performed. When the file is closed, a 
1 00-character trailer is punched. 

When ppt is opened for reading, the process waits 
until tape is placed in the reader and the reader 
is on-line. Then requests to read cause the 
characters read to be passed back to the program, 
again without any editing. This means that 
several null leader characters will usually ap- 
pear at the beginning of the file. Likewise 
several nulls are likely to appear at the end. 
End-of-file is generated when the tape runs out. 

Seek calls for this file are meaningless. 

/dev/ppt 
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NAME 

DESCRIPTION 



FILES 
SEE ALSO 
BUGS 



rf — RF11-RS11 fixed-head disk file 

This file refers to the concatenation of both 
RS-1 1 disks. It may be either read or written, 
although writing is inherently very dangerous, 
since a file system resides there. 

The disk contains 2048 256-word blocks, numbered 
to 2047. Like the other block-structured dev- 
ices (tc, RK) this file is addressed in blocks, 
not bytes. This has two consequences: seek calls 
refer to block numbers, not byte numbers; and 
sequential reading or writing always advance the 
read or write pointer by at least one block. 
Thus successive reads of 10 characters from this 
file actually read the first 10 characters from 
successive blocks. 

/dev/rfO 

tc(iv), rk(iv) 

The fact that this device is addressed in terms 
of blocks, not bytes, is extremely unfortunate. 
It is due entirely to the fact that read and 
write pointers (and consequently the arguments to 
seek) are single-precision numbers. 
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NAME 

DESCRIPTION 



FILES 



SEE ALSO 
BUGS 



rk — RK-11/RK03 (or RK05) disk 

rk? refers to an entire RK03 disk as a single 
sequentially-addressed file. Its 256-word blocks 
are numbered to 4871 . Like the RF disk and the 
tape files, its addressing is block-oriented. 
Consult the rf (IV) section. 



/dev/rkO 
/dev/rk1 
/dev/rk2 
/dev/rk3 

rf(iv), tc(iv) 

See rf(iv) 



user available drive 
/usr file system 
/sys file system 
/crp file system 



- 1 - 



TC (IV) 



3/15/72 



TC (IV) 



NAME tc — TC-11/TU56 DEC tape 

DESCRIPTION The files tapO ... tap? refer to the TC-11/TU56 

DECtape drives to 7. Since the logical drive 
number can be manually set, all eight files exist 
even though at present there are fewer physical 
drives. 

The 256-word blocks on a standard DECtape are 
numbered to 577. However, the system makes no 
assumption about this number; a block can be read 
or written if it exists on the tape and not oth- 
erwise. An error is returned if a transaction is 
attempted for a block which does not exist. 

Addressing on the tape files, like that on the RK 
and RF disks, is block-oriented. 

FILES /dev/tap? 

SEE ALSO rf(lV), tap(l) 



BUGS 



see rf(iv) 
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NAME tm — TM-11/TU-.10 magtape interface 

DESCRIPTION mt? is the DEC TU1 O/TMI 1 magtape. When opened 

for reading or writing^ the magtape is rewound. 
A tape consists of a series of 512 byte records 
terminated by an end-of-file. Reading less than 
512 bytes causes the rest of a record to be ig- 
nored. Writing less than a record causes null 
padding to 512 bytes, when the magtape is closed 
after writing, an end-of-file is written. 

Seek has no effect on the magtape. The magtape 
can only be opened once at any instant. 

FILES /dev/mtO selected drive 



SEE ALSO mt(l) 

BUGS Seek should work on the magtape. Also, a provi 

sion of having the tape open for reading and 
writing should exist. A multi-file and multi- 
reel facility should be incorporated. 
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NAME vt — 11/20 (vtOI ) interface 

DESCRIPTION 

The file vtO provides the interface to a PDP 11/20 which 
runs both a VTOI A-cont rolled Tektronix 611 storage 
display, and a Federal Screw Works (vocal interface Divi- 
sion) voice synthesizer. The inter-computer interface is 
a pair of DR-11C word interfaces. 

Although the display^has essentially onl^ two commands, 
namely "erase screen" and "display point , the 11/20 pro- 
gram will draw points, lines, and arcs, and print text oh 
the screen. The 11/20 can also type information on the 
attached 33 TTY and generate utterances via the voice 
synthesizer. 

This special file operates in two basic modes, selected 
by bit 2 (octal 04) on the 1l/20's console switches. If 
this bit is on at the opening of the file, all bytes 
written on the file are interpreted as ASCII characters 
and written on the screen. The screen has 33 lines (l/2 
a standard page). The file simulates a 37 TTY: the con- 
trol characters NL, CR, BS, and TAB are interpreted 
correctly. It also interprets the usual escape sequences 
for forward and reverse half-line motion and for full- 
line reverse. Greek is not available yet. Normally, 
when the screen is full (i.e. the 34th line is started) 
the screen is erased before starting a new page. To 
allow perusal of the displayed text, it is usual to as- 
sert bit of the console switches (octal 01). As ex- 
plained below, this causes the program to pause before 
erasing until one of the attached pushbuttons is 
depressed. 

If bit 2 of the switches is down, the display is in 
graphic mode. In this case bytes written on the file are 
interpreted as display and vocal commands. Each command 
consists of a single byte usually followed by parameter 
bytes. Often the parameter bytes represent points in the 
plotting area. Each point coordinate Consists of 2 bytes 
interpreted as a 2*s complement 1 6— bit number. The plot- 
ting area itself measures ( +03777 )X( +03777) (numbers in 
octal); that is, 12 bits of ""precision. Attempts to plot 
points outside the screen limits are ignored. 

The graphic and sonic commands are: 

order (1); 1 parameter byte 

The parameter indicates a subcommand, possibly fol- 
lowed by subparameter bytes, as follows: 

erase (l ) 

The screen is erased. This action may be de- 
layed, as explained below, until a pushbutton 
is depressed. 
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label (2); several subparameter bytes 

The following bytes up to a null character are 
taken as a label and typed on the console TTY. 
One of the console switches gives labels a spe- 
cial interpretation, as explained below, 

display label (3); several subparameter bytes 
The following bytes up to a null byte are 
printed as ASCII text on the screen. The ori- 
gin of the text is the last previous point 
plotted; or the upper left hand of the screen 
if there were none, 

point (2); 4 parameter bytes 

The 4 parameter bytes are taken as a pair of coordi- 
nates representing a point to be plotted, 

line (3); 8 parameter bytes 

The parameter bytes are taken as 2 pairs of coordi- 
nates representing the ends of a line segment which 
is plotted. Only the portion lying within the 
screen is displayed, 

frame ( 4 ) ; 1 parameter byte 

The parameter byte is taken as a number of sixtieths 
of a second; an externally-available lead is assert- 
ed for that time. Typically the lead is connected 
to an automatic camera which advances its film and 
opens the shutter for the specified time, 

circle (5); 6 parameter bytes 

The parameter bytes are taken as a coordinate pair 
representing the origin, and a word representing the 
radius of a circle. That portion of the circle 
which lies within the screen is plotted, 

arc (6); 12 parameter bytes 

The first 4 parameter bytes are taken to be a 
coordinate-pair representing the center of a circle. 
The next 4 represent a coordinate-pair specifying a 
point on this circle. The last 4 should represent 
another point on the circle. An arc is drawn 
counter-clockwise from the first circle point to the 
second. If the two points are the same, the whole 
circle is drawn. For the second point, only the 
smaller in magnitude of its two coordinates is 
significant; the other is used only to find the qua- 
drant of the end of the arc. In any event only 
points within the screen limits are plotted, 

dot-line (7); at least 6 parameter bytes 

The first 4 parameter bytes are taken as a 
coordinate-pair representing the origin of a dot- 
line. The next byte is taken as a signed x- 
increment. The next byte is an unsigned word-count, 
with "o" meaning **256** » The indicated number of 
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words is picked up. For each bit in each word a^^ 
point is plotted which is visible if the bit is 
invisible if not. High-order bitis are plotted 
first. Each successive point (or non-point) is 
offset rightward by the given x-increment. 

speak (8); several parameter bytes 

The following bytes up to a null byte are taken to 
represent phonemes which are fed to the voice syn- 
thesizer. vsp(VIl) gives the encoding. 

The 3 low-order console switches of the 11/20 modify the 
operation of the display as follows. 

Bit 2 (octal 04) is examined at the time the display file 
is opened (more precisely, when the first byte is written 
after an open) ; as indicated, when on it selects charac- 
ter mode, otherwise graphic mode. 

Bit 1 (octal 02) determines whether TTY labels are to be 
interpreted. Unless this bit is on, labels are ignored, 
(except to terminate skip mode, see below). 

Bit (octal 01 ) determines whether the display will 
pause before erasing the screen; if off there will be no 
pause. If bit is on, the erase will occur and display- 
ing will resume only when one of the 16 pushbuttons is 
depressed. 

There is a box with 16 pushbuttons connected to the 
11/20. Their state is at all times available in the 
11/45 by executing the csw system call (II )• They are 
used by the 11/20 when it is pausing before an erase. 14 
of the buttons merely serve to allow the display to con- 
tinue. If, however, button 7 is pushed, the display will 
ignore commands up to the next erase command, then ring 
the TTY console's bell, thereby skipping an entire pic- 
ture . 

If button 8 is depressed, the display will ignore com- 
mands up to the next TTY label (whether or not its typing 
is suppressed) before resviming the displays. Thus a 
sequence of frames may be skipped. 



FILES 



/dev/vtO 



SEE ALSO 



csw(ll), vsp(VIl) 



BUGS 



Two users using vtO simultaneously can interfere 
with each other, e.g. plot phonemes or speak 
display coordinates. 
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NAME a. out — assembler and link editor output 

DESCRIPTION 

a, out is the output file of the assembler as and the link 
editor Id. In both cases , a »out may be executed provided 
there were no errors and no unresolved external refer- 
ences* 

This file has four sections: a header, the program and 
data text, a symbol table, and relocation bits (in that 
order) • The last two may be empty if the program was 
loaded with the "-s" option of Id or if the symbols and 
relocation have been removed by strip . 

The header always contains 8 words: 

1 A magic number (407(8)) 

2 The size of the program text segment 

3 The size of the initialized data segment 

4 The size of the uninitialized (bss) segment 

5 The size of the symbol table 

6 The entry location (always at present) 

7 The stack size required (0 at present) 

8 A flag indicating relocation bits have been 
suppressed 

The sizes of each segment are in bytes but are even. The 
size of the header is not included in any of the other 
sizes • 

When a file produced by the assembler or loader is loaded 
into core for execution, three segments are set up: the 
text segment, the data segment, and the bss (uninitial- 
ized data) segment, in that order. The text segment 
begins at the lowest location in the core image; the 
header is not loaded. The data segment begins immediate- 
ly after the text segment, and the bss segment immediate- 
ly after the data segment. The bss segment is initial- 
ized by O's. In the future the text segment will be 
write-protected and shared. 

The start of the text segment in the file is 20(8); the 
start of the data segment is 20+S^ (the size of the text) 
the start of the relocation information is 20+S.+s^; the 
start of the symbol table is 20+2(S^+s^a) if the reloca- 
tion information is present, 20+S^+s^ if not. 

The symbol table consists of 6-word entries. The first 
four contain the ASCII name of the symbol, null-padded. 
The next word is a flag indicating the type of symbol. 
The following values are possible: 

00 undefined symbol 

01 absolute symbol 

02 text segment symbol 

03 data segment symbol 
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04 bss segment symbol 

40 undefined external (.globl) symbol 

41 absolute external symbol 

42 text segment external symbol 

43 data segment external symbol 

44 bss segment external symbol 

Values other than those given above may occur if the user 
has defined some of his own instructions. 

The last word of a symbol table entry contains the value 
of the symbol . 

If the symbol's type is undefined external, and the value 
field is non-zero, the symbol is interpreted by the 
loader Id as the name of a common region whose size is 
indicated by the value of the symbol. 

The value of a word in the text or data portions which is 
not a reference to an undefined external symbol is exact- 
ly that value which will appear in core when the file is 
executed. If a word in the text or data portion involves 
a reference to an undefined external symbol, as indicated 
by the relocation bits for that word, then the value of 
the word as stored in the file is an offset from the 
associated external symbol. When the file is processed 
by the link editor and the external symbol becomes de- 
fined, the value of the symbol will be added into the 
word in the file. 

If relocation information is present, it amounts to one 
word per word of program text or initialized data. There 
is no relocation information if the "suppress relocation" 
flag in the header is on. 

Bits 3-1 of a relocation word indicate the segment re- 
ferred to by the text or data word associated with the 
relocation word: 



00 


indicates 


the 


reference 


is 


absolute 


02 


indicates 


the 


reference 


is 


to 


the text segment 


04 


indicates 


the 


reference 


is 


to 


the data segment 


06 


indicates 


the 


reference 


is 


to 


the bss segment 


10 


indicates 
symbol. 


the 


reference 


is 


to 


an undefined external 



Bit of the relocation word indicates if on that the 
reference is relative to the pc (e.g. "clr x''^; if off * 
the reference is to the actual symbol (e.g., clr *$x ). 



The remainder of the relocation word (bits 15-4) contains 
a symbol number in the case of external references, and 
is unused otherwise. The first symbol is numbered 0, the 
second 1 , etc. 

SEE ALSO as. Id, strip . nm« un(l ) 
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NAME 

DESCRIPTION 



archive (library) file format 

The archive command ar is used to combine several 
files into one. Archives are used mainly as 
libraries to be searched by the link-editor Id. 

A file produced by ar has a "magic number" at the 
start, followed by the constituent files, each 
preceded by a file header. The magic number is 
177555(8) (it was chosen to be unlikely to occur 
anywhere else). The header of each file is 16 
bytes long: 



0-7 



file name, null padded on the right 



8-1 1 

Modification time of the file 

12 

User ID of file owner 

13 

file mode 

14-15 

file size 

If the file is an odd number of bytes long, it is 
padded with a null byte, but the size in the 
header is correct. 

Notice there is no provision for empty areas in 
an archive file. 

SEE ALSO ar. Id 
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NAME format of core image 

DESCRIPTION UNIX writes out a core image of a terminated pro- 

cess when any of various errors occur. See 
wait ( II ) for the list of reasons; the most common 
are memory violations, illegal instructions, bus 
errors, and user-generated quit signals. 

The core image is called "core" and is written in 
the process's working directory (provided it can 
be; normal access controls apply). 

The size and structure of the core image file 
depend to some extent on which system is in- 
volved. In general there is a 512-byte area at 
the end which contains the system's per-process 
data for that process. (64 bytes in older sys- 
tems). The remainder represents the actual con- 
tents of the user's core area when the core image 
was written. In the current system, this area is 
variable in size in that only the locations from 
user to the program break, plus the stack, are 
dumped. 

When any fatal trap occurs, all the useful regis- 
ters are stored on the stack. In the current 
system, which has relocation and protection 
hardware, the stack used is the system stack, 
which is kept in the per-process area; in older 
systems, there is only one stack, and it is lo- 
cated in the user's core area. 

The actual format of the information is compli- 
cated because it depends on what hardware is 
present (EAE, floating-point option), whether 
single- or double-precision floating mode is in 
effect, and also involves relocating addresses in 
the system's address space. A guru will have to 
be consulted if enlightenment is required. 

In general the debugger db(l) should be used to 
deal with core images. 

SEE ALSO db(l), wait(ll) 
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NAME 

DESCRIPTION 



SEE ALSO 



format of directories 

A directory behaves exactly like an ordinary 
file, save that no user may write into a directo- 
ry. The fact that a file is a directory is indi- 
cated by a bit in the flag word of its i-node 
entry. 

Directory entries are 10 bytes long. The first 
word is the i-number of the file represented by 
the entry, if non-zero; if zero, the entry is 
empty , 

Bytes 2-9 represent the (8-character) file name, 
null padded on the right. These bytes are not 
cleared for empty slots. 

By convention, the first two entries in each 
directory are for *'," and The first is an 

entry for the directory itself. The second is 
for the parent directory. The meaning of is 
modified for the root directory of the master 
file system and for the root directories of re- 
movable file systems. In the first case, there 
is no parent, and in the second, the system does 
not permit off-device references. Therefore in 
both cases has the same meaning as 

file system (V) 
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NAME format of file system 

DESCRIPTION 

Every file system storage volume (e.g. RF disk, RK disk, 
DECtape reel) has a common format for certain vital in- 
formation. 

Every such volume is divided into a certain number of 256 
word (512 byte) blocks. Blocks and 1 are collectively 
known as the super-block for the device; they define its 
extent and contain an i-node map and a free-storage map. 
The first word contains the numiser of bytes in the free- 
storage map; it is always even. It is followed by the 
map. There is one bit for each block on the device; the 
bit is "l " if the block is free. Thus if the number of 
free-map bytes is n, the blocks on the device are num- 
bered through 8 n-1 . The free-map count is followed by 
the free map itself. The bit for block k of the device 
is in byte k/8 of the map; it is offset k(mod 8) bits 
from the right. Notice that bits exist for the super- 
block and the i-list, even though they are never allocat- 
ed or freed. 

After the free map is a word containing the byte count 
for the i-node map. It too is always even. I -numbers 
below 41(10) are reserved for special files, and are 
never allocated; the first bit in the i-node free map 
refers to i-number 41 . Therefore the byte number in the 
i-node map for i-node i is (1-41 )/8. It is of f set ( i-41 ) 
(mod 8) bits from the right; ""unlike the free map, a ^o" 
bit indicates an available i-node. 

I-numbers begin at 1, and the storage for i-nodes begins 
at block 2. Also, i-nodes are 32 bytes long, so 1 6 of 
them fit into a block. Therefore, i-node i is located in 
block (i+3l)/l6 of the file system, and begins 
32* ( (i+31 ) (mod 1 6) ) bytes from its start. 

There is always one file system which is always mounted; 
in standard UNIX it resides on the RF disk. This device 
is also used, for swapping. On the primary file system' 
device, there are several pieces of information following 
that previously discussed. There are two words with the 
calendar time (measured since 00:00 Jan 1, 1972); two 
words with the time spent executing in the system; two 
words with the time spent waiting for l/O on the RF and 
RK disks; two words with the time spent executing in a 
user's core; one byte with the count of errors on the RF 
disk; and one byte with the count of errors on the RK 
disk. All the times are measured in sixtieths of a 
second . 

I-node 41(10) is reserved for the root directory of the 
file system. No i-numbers other than this one and those 
from 1 to 40 (which represent special files) have a 
built-in meaning. Each i-node represents one file. The 
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format of an i-node is as follows, where the left column 
represents the offset from the beginning of the i-node : 

0-1 flags (see below) 

2 number of links 

3 user ID of owner 
4-5 size in bytes 

6-7 first indirect block or contents block 
• • • 

20-21 eighth indirect block or contents block 

22-25 creation time 

26-29 modification time 
30-31 unused 

The flags are as follows: 

100000 i-node is allocated 

040000 directory 

020000 file has been modified (always on) 

010000 large file 

000040 set user ID on execution 

000020 executable 

000010 read, owner 

000004 write, owner 
000002 read, non-owner 
000001 write, non-owner 

The allocated bit (flag 100000) is believed even if the 
i-node map says the i— node is free; thus corruption of 
the map may cause i-nodes to become unallocatable, but 
will not cause active nodes to be reused. 

Byte number n of a file is accessed as follows: n is 
divided by 512 to find its logical block number Jsay b) 
in the file. If the file is small (flag 010000 is 0), 
then b must be less than 8, and the physical block number 
corresponding to b is the bth entry in the address por- 
tion of the i-node. ~ 

Even if the file is large, b will be less than 128 
(128*512 = 2^16). The first number in the i-node address 
portion gives the physical block number of the indirect 
block, b is doubled to give a byte offset in the in- 
direct block and the word there found is the physical 
address of the block corresponding to b. 

For block b in a file to exist, it is not necessary that 
all blocks~less than b exist. A zero block number either 
in the address words of the i-node or in an indirect 
block indicates that the corresponding block has never 
been allocated. Such a missing block reads as if it con- 
tained all zero words. 

BUGS Two blocks are not enough to handle the i- and 

free-storage maps for an RP02 disk pack, which 
contains around 10 million words. 
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NAME 

DESCRIPTION 



passwd — password file 

passwd contains for each user the following 
information: 

name (login name, contains no upper case) 

encrypted password 

numerical user ID 

GCOS job number and box number 

initial working directory 

program to use as Shell 

This is an ASCII file. Each field within each 
user's entry is separated from the next by a 
colon. The job and box numbers are separated by 
a comma. Each user is separated from the next by 
a new-line. If the password field is null, no 
password is demanded; if the Shell field is null, 
the Shell itself is used. 

This file resides in directory /etc. Because of 
the encrypted passwords, it can and does have 
general read permission and can be used, for 
example, to map numerical user ID's to names. 



SEE ALSO 



login(l), crypt(lll), passwd(l) 
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NAME 

DESCRIPTION 



tap — DEC/mag tape formats 

The DECtape command tap and the magtape command 
mt dump and extract files to and from their 
respective tape media. The formats of these 
tapes are the same except that magtapes have 
larger directories. 

Block zero of the tape is not used. It is avail- 
able to contain a boot program to be used in a 
stand-alone environment. This has proved valu- 
able for DEC diagnostic programs. 

Blocks 1 through 24 for DECtape ( 1 through 1 46 
for magtape) contain a directory of the tape. 
There are 192 (resp. 1168) entries in the 
directory; 8 entries per block; 64 bytes per 
entry. Each entry has the following format: 



path name 
mode 
uid 
size 

time modified 
tape address 
unused 
check sum 



32 bytes 
1 byte 

1 byte 

2 bytes 
4 bytes 
2 bytes 
20 bytes 
2 bytes 



The path name entry is the path name of the file 
when put on the tape. If the pathname starts 
with a zero word, the entry is empty. It is at 
most 32 bytes long and ends in a null byte. 
Mode, uid, size and time modified are the same as 
described under i-nodes (see file system (v)) The 
tape address is the tape block number of the 
start of the contents of the file. Every file 
starts on a block boundary. The file occupies 
(size+51 1 )/51 2 blocks of continuous tape. The 
checksum entry has a value such that the sum of 
the 32 words of the directory entry is zero. 

Blocks 25 (resp. 147) on are available for file 
storage. 

A fake entry (see mt(l), tap(i)) has a size of 
zero. 



SEE ALSO 



f ilesystem(v) , mt(l), tap(l) 
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/trap/utmp — user information 

This file allows one to discover information 
about who is currently usina UNIX. The file is 
binary; each entry is 16(10; bytes long. The 
first eight bytes contain a user's login name or 
are null if the table slot is unused. The low 
order byte of the next word contains the last 
character of a typewriter name. The next two 
words contain the user's login time. The last 
word is unused. 

This file resides in directory /tmp. 

/etc/init, which maintains the file; 
who(l), which interprets it. 
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WTMP (V) 



NAME 

DESCRIPTION 



SEE ALSO 



/tmp/wtmp — user login history 

This file records all logins and logouts, its 
format is exactly like utmp(v) except that a null 
user name indicates a logout on the associated 
typewriter, and the typewriter name *x' indicates 
that UNIX was rebooted at that point. 

Wtmp is maintained by login(l) and init(vil). 
Neither of these programs creates the file, so if 
it is removed record-keeping is turned off. 

This file resides in directory /tmp. 

init(VIl), login(l), acct(VIIl), swtmp(vill) 
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BC (VI) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 

DIAGNOSTICS 
BUGS 



be — B interpreter 



ofile 



be is the UNIX B interpreter, 
types of arguments : 



It accepts three 



Arguments whose names end with .b are assumed 
to be B source programs; they are compiled, and 
the object program is left on the file sfile. .o 
(i.e. the file whose name is that of the source 
with ".o" substituted for ".b"). 

Other arguments (except for "^e") are assumed to 
be either loader flag arguments, or B-compatible 
object programs, typically produced by an earlier 
be run, or perhaps libraries of B-compatible 
routines. These programs, together with the 
results of any compilations specified, are loaded 
(in the order given) to produce an executable 
program with name a .out . 

The "-c" argument suppresses the loading phase, 
as does any syntax error in any of the routines 
being compiled. 

The language itself is described in [1] . 

The future of B is uncertain. The language has 
been totally eclipsed by the newer, more power- 
ful, more compact, and faster language C. 



file.b 
a .out 
b.tmpi 
b.tmp2 

/u sr/ lang/bd ir/b [e a] 
/usr/lang/bdir/brt[l 2] 
/usr/lib/libb.a 
/usr/lang/bdir/bilib.a 



input file 
lojaded output 
temporary (deleted) 
temporary (deleted) 
translator 

runtime initialization 
builtin functions, etc. 
interpreter library 



[1] K. Thompson; MM-72-1 271 -1 ; Users' Reference 

to B. 

ce(l) 

see [1] . 

Certain external initializations are illegal, 
(in particular: strings and addresses of exter- 
nals.) 
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BJ (VI) 



NAME bj — the game of black jack 

SYNOPSIS /usr/games/b j 

DESCRIPTION 

bJ is a serious attempt at simulating the dealer in the 
game of black jack (or twenty-one) as might be found in 
Reno. The following rules apply; 

The bet is $2 every hand. 

A player 'natural' (black jack) pays $3. A dealer 
natural loses $2. Both dealer and player naturals is 
a 'push' (no money exchange). 

If the dealer has an ace up, the player is allowed to 
make an 'insurance' bet against the chance of a dealer 
natural. If this bet is not taken, play resumes as 
normal. If the bet is taken, it is a side bet where 
the player wins $2 if the dealer has a natural and 
loses $1 if the dealer does not. 

If the player is dealt two cards of the same value, he 
is allowed to 'double'. He is allowed to play two 
hands, each with one of these cards. (The bet is dou- 
bled also; $2 on each hand.) 

If a dealt hand has a total of ten or eleven, the 
player may 'double down'. He may double the bet ($2 
to $4) and receive exactly one more card on that hand. 

Under normal play, the player may 'hit' (draw a card) 
as long as his total is not over twenty-one. If the 
player 'busts' (goes over twenty-one), the dealer wins 
the bet. 

When the player 'stands' (decides not to hit), the 
dealer hits until he attains a total of seventeen or 
more. If the dealer busts, the player wins the bet. 

If both player and dealer stand, the one with the 
largest total wins. A tie is a push. 

The machine deals and keeps score. The following ques- 
tions will be asked at appropriate times. Each question 
is answered by y, followed by a new line for 'yes', or 
Just new line for 'no' . 

? (means, "do you want a hit?") 

Insurance? 

Double down? 

Every time the deck is shuffled, the dealer so states and 
the 'action' (total bet) and 'standing' (total won or 
loss) is printed. To exit, hit the interrupt key (DEL) 
and the action and standing will be printed. 



PTX (VI) 



3/1 5/72 



PTX (VI) 



NAME 

SYNOPSIS 

DESCRIPTION 



ptx — permuted index 
ptx input output 

ptx generates a permuted index from file input on 
file output. It has three phases; the first does 
the permutation, generating one line for each 
keyword in an input line. The keyword is rotated 
to the front. The permuted file is then sorted. 
Finally the sorted lines are rotated so the key- 
word comes at the middle of the page. 

input should be edited to remove useless lines^ 
The following words are suppressed: "a", "and - 

M tl II It l» It It _ »l tl - It It It ••., »• •» »t 

^^as , is , for , of , on , or , the , to , 



The index for this manual was generated using 
ptx. 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



sort (I) 
some 
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YACC (VI) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 



DIAGNOSTICS 



BUGS 



yacc — yet another compiler compiler 
/crp/sc 1/vacc [ <grammar ] 

Yacc converts a context-free grammar into a set 
of tables for a simple automaton which executes 
an LR(1) parsing algorithm* The tables are pro- 
vided in readable form on the standard output and 
in b-cpmpiler format on file actn.b; the program 
/crp/sc j/bpar.b will parse strings using the 
actn.b file. 

If your grammar is too big for yacc, you may try 
/crp/sc j/bigyacc, some of whose size limits are 
larger, and others smaller. 

actn.b output tables 

actn.tmp temporary storage 

Note that these files are created in the 

invoker's directory. The file actn.tmp is only 

created by /crp/sc j/bigyacc (see above). 

Yacc manual, by scj (available from ek); "lR 
Parsing**, by A. V. Aho and S. C. Johnson, to be 
published. 

There are various diagnostics, but only one can 
be obtained in each run. 

The maximum number of terminal and non-terminal 
symbols is 50 each, and this is not checked. 
There are undoubtedly other bugs too. 
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ASCII (VII) 



NAME ascii — map of ASCII character set 



SYNOPSIS cat /usr/pub/ascli 

DESCRIPTION ascll is a map of the ASCII character set, to be 

printed as needed. It contains: 



looo 


nul 


|001 


soh 


}002 


stx 


003 


etxl004 


eot 


005 


enq 


006 


ack 


1007 


bell 


|01 


bs 


i 01 1 


ht 


j012 


nl 


01 3 


vt 


014 


np 


01 5 


cr 


01 6 


so 


1017 


si j 


|020 


die 


|021 


del 


|022 dc2 


023 


dc3 


1024 


dc4 


025 


nak 


026 


syn 


1027 


etbj 


|030 


can 


j031 


em 


1032 


sub 


033 


esc 


i034 


fs 


035 


gs 


036 


rs 


1037 


us 1 


|040 


sp 


}041 


! 


1042 


If 


043 


# 


044 


$ 


045 


% 


046 


& 


1047 


' 1 


j050 


( 


i05l 


) 


1052 


* 


053 


+ 


054 


» 


055 




i056 


• 


1057 


/ j 


i060 





J 061 


1 


1062 


2 


063 


3 


064 


4 


065 


5 


066 


6 


}067 


7 j 


j070 


8 


1071 


9 


j072 


• 


073 


• 

» 


074 


< 


075 




076 


> 


|077 


? 1 


jl 00 


@ 


jioi 


A 


1102 


B 


103 


C 


104 


D 


105 


E 


|106 


F 


1107 


G 1 


il 10 


H 


jlll 


I 


1112 


J 


113 


K 


114 


L 


115 


M 


116 


N 


1117 


j 


jl 20 


P 


1121 


Q 


}122 


R 


il 23 


S 


|1 24 


T 


1125 


U 


|1 26 


V 


ll 27 


w 1 


jl 30 


X 


jl 31 


Y 


}1 32 


Z 


133 


[ 


[1 34 


\ 


135 


] 


1 36 




jl 37 




jl40 




jl41 


a 


1142 


b 


143 


c 


144 


d 


145 


e 


1146 


f 


jl47 


g 1 


jl 50 




jl51 


i 


1152 


j 


153 


k 


|154 


1 


,155 


m 


il56 


n 


il57 


o 1 


jl 60 


P 


}161 


q 


1162 


r 


163 


s 


|1 64 


t 


165 


u 


[166 


V 


}167 


w 1 


jl 70 


X 


|171 


y 


jl72 


z 


173 


{ 


1174 


j 


175 


} 


[176 




1177 


deli 



FILES 



found in /usr/pub 
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DPD (VII) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



dpd — spawn data phone daemon 
/etc/dpd 

dpd is the 201 data phone daemon. It is designed 
to submit jobs to the Honeywell 6070 computer via 
the gerts interface. 

dpd uses the directory /usr/dpd . The file lock 
in that directory Is used to prevent two daemons 
from becoming active. After the daemon has suc- 
cessfully set the lock, it forks and the main 
path exits, thus spawning the daemon, /usr/dpd 
is scanned for any file beginning with df. Each 
such file is submitted as a job. Each line of a 
job file must begin with a key character to 
specify what to do with the remainder of the line 

S directs dpd to generate a unique snumb card. 
This card is generated by incrementing the 
first word of the file /u sr /dpd/ s numb and con- 
verting that to decimal concatenated with the 
station ID. 

L specifies that the remainder of the line is 
to be sent as a literal. 

B specifies that the rest of the line is a 
file name. That file is to be sent as binary 
cards. 

F is the same as B except a form feed is 
prepended to the file. 

U specifies that the rest of the line is a 
file name. After the job has been transmit- 
ted, the file is unlinked. 

Any error encountered will cause the daemon to 
drop the call, wait up to 20 minutes and start 
over. This means that an improperly constructed 
df file may cause the same job to be submitted 
every 20 minutes. 

While waiting, the daemon checks- to see that the 
lock file still exists. If the lock is gone, the 
daemon will exit. 

/dev/dnO, /dev/dpO, /usr/dpd/* 

opr(l) 
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GETTY (VII) 



NAME 



getty — set typewriter mode and get user's name 



SYNOPSIS 



/etc/getty 



DESCRIPTION 



getty is invoked by init (VIl) immediately after a type- 
writer is opened following a dial-in. The user's login 
name is read and the login(l) command is called with this 
name as an argument. While reading this name getty at- 
tempts to adapt the system to the speed and type of ter- 
minal being used, 

getty initially sets the speed of the interface to 150 
baud, specifies that raw mode is to be used (break on 
every character), that echo is to be suppressed, and 
either parity allowed. It types the "login:" message 
(which includes the characters which put the 37 Teletype 
terminal into full-duplex and unlock its keyboard). Then 
the user's name is read, a character at a time. If a 
null character is received, it is assumed to be the 
result of the user pushing the "break" ("interrupt") |jey« 
The speed is then changed to 300 baud and the "login:" is 
typed again, this time with the appropriate sequence 
which puts a GE TermiNet 300 into full-duplex. This 
sequence is acceptable to other 300 baud terminals also. 
If a subsequent null character is received, the speed is 
changed again. The general approach is to cycle through 
a set of speeds in response to null characters caused by 
breaks. The sequence at this installation is 150, 300, 
and 134.5 baud. 

Detection of IBM 2741 s is accomplished while the s^eed is 
set to 150 baud. The user sends a 2741 style "eot char- 
acter by pushing the attention key or by typing return; 
at 150 baud, this character looks like the ascii *"" 
(174q), Upon receipt of the^"eot", the system is set to 
operate 2741s and a "login: " message is typed. 

The user's name is terminated by a new-line or carriage- 
return character. The latter results in the system being 
set to to treat carriage returns appropriately (see 
stty(ll)). 

The user's name is scanned to see if it contains any 
lower-case alphabetic characters; if not, and if the name 
is nonempty, the system is told to map any future upper- 
case characters into the corresponding lower-case charac- 
ters. Thus UNIX is usable from upper-case-only termi- 
nals , 

Finally, login is called with the user's name as argu- 
ment. 



FILES 



SEE ALSO 



init(VIl), login(l), stty(ll) 
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GLOB (VII) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



glob — generate command arguments 
/etc/glob 

glob is used to expand arguments to the shell 
containing '[', or "?". It is passed the 

argument list containing the metacharacters; glob 
expands the list and calls the command itself. 
The actions of glob are detailed in the Shell 
writeup, 

found in /etc/glob 
sh(l) 

"no match", "no command", "no directory" 



If any of '[', or occurs both quoted and 

unquoted in the original command line, even the 
quoted metacharacters are expanded. 

glob gives the "no match" diagnostic only if no 
arguments at all result. This is never the case 
if there is any argument without a metacharacter. 
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GREEK (VII ) 



NAME 

SYNOPSIS 

DESCRIPTION 



greek — graphics for extended a sell type box 
cat /u sr/pub/ crre ek 

greek gives the mapping from a sell to the "shift 
out graphics in effect between SO and SI on 
model 37 teletypes with a 1 28-character type box. 
It contains : 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



alpha 


a 


A 


beta 




B 


gamma 


Y 


\ 


GAMMA 


r 


G 


delta 


8 


D 


DELTA 


A 


W 


epsilon 


e 


s 


zeta 




Q 


eta 




N 


theta 


e 


T 


THETA 


e 





lambda 


X 


L 


LAMBDA 


A 


E 


mu 




M 


nu 


V 


@ 


xi 




X 


pi 




J 


PI 


n 


P 


rho 


p 


K 


Sigma 


cy 


Y 


SIGMA 


I 


R 


tau 


r 


I 


phi 


<p 


U 


PHI 


$ 


F 


psi 




V 


PSI 


4' 


H 


omega 




C 


OMEGA 


n 


z 


nabla 


V 


I 


not 


—1 




partial 


b 


] 


integral 


s 
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INIT (VII) 



NAME 



init — process control initialization 



SYNOPSIS 



/etc/init 



DESCRIPTION 



init is invoked inside UNIX as the last step in the boot 
procedure. Generally its role is to create a process for 
each typewriter on which a user may log in. 

First, init checks to see if the console switches contain 
1 73030. (This number is likely to vary between systems.) 
If so, the console typewriter tty is opened for reading 
and writing and the shell is invoked immediately. This 
feature is used to bring up a test system, or one which 
does not contain DC-1 1 communications interfaces. When 
the system is brought up in this way, the qetty and login 
routines mentioned below and described elsewhere are not 
needed. 

Otherwise, init does some housekeeping: the mode of each 
DECtape file is changed to 17 (in case the system crashed 
during a tap command); directory /usr is mounted on the 
RKO disk; directory /sys is mounted on the RKI disk. 
Also a data-phone daemon is spawned to restart any jobs 
being sent. 

"^^^^ i^^^t forks several times to create a process for 
each typewriter mentioned in an internal table. Each of 
these processes opens the appropriate typewriter for 
reading and writing, . These channels thus receive file 
descriptors and 1 , the standard input and output. 
Opening the typewriter will usually involve a delay, 
since the open is not completed until someone is dialled 
in (and carrier established) on the channel. Then the 
process executes the program / etc / getty (q.v.). qetty 
will read the user's name and invoke login (q.v.) to log 
in the user and execute the shell. 

Ultimately the shell will terminate because of an end- 
of-file either typed explicitly or generated as a result 
of hanging up. The main path of init . which has been 
waiting for such an event, wakes up and removes the ap- 
propriate entry from the file utmp . which records current 
users, and makes an entry in wtmp . which maintains a his- 
tory of logins and logouts. Then the appropriate type- 
writer is reopened and qetty re invoked. 



FILES 



SEE ALSO 



/dev/tap?, /dev/tty, /dev/tty?, /tmp/utmp, 
/tmp/wtmp 

login(l), login(VIl), getty(VIl), sh(l), dpd(VIl) 



DIAGNOSTICS 



none possible 



BUGS 



none possible 
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MSH (VII) 



NAME 

SYNOPSIS 

DESCRIPTION 



msh — mini-shell 
/etc/msh 

msh is a heavily simplified version of the Shell 
It reads one line from the standard input file, 
interprets it as a command, and calls the com- 
mand. 

The mini-shell supports few of the advanced 
features of the Shell; none of the following 
characters is special: 

> < $ \ ; & 

However, "[", and are recognized and 

glob is called. The main use of msh is to pro- 
vide a command-executing facility for various 
interactive sub-systems. 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



sh(l), glob(VIl) 



n If 

? 
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TABS (VII) 



NAME 

SYNOPSIS 

DESCRIPTION 



tabs — set tab stops 
cat /usr/pub/tabs 

When printed on a suitable terminal, this file 
will set tab stops every 8 columns. Suitable 
terminals include the Teletype model 37 and the 
GE TermiNet 300. 



These tab stop settings are desirable because 
UNIX assumes them in calculating delays. 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 
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VSP (VII) 



NAME 

SYNOPSIS 

DESCRIPTION 



vsp — voice synthesizer code 
cat /usr/pub/vsp 

VSP contains a list of phonemes understood by the 
voice synthesizer on device vt. Phonemes are 
usually written in the form 

comma inflection phoneme 

The inflection and the phoneme codes are or-ed 
together. The phoneme codes are as follows 
(numbers in octal). 



u 




ouu 




P 






i 
1 








a n 

au 










1 uu 








3 <£ 






UUU 


weaK mrxecuxon 


ai 




J / 










a J 




1 1 


aw 




no 
UZ 


awrux ±aw 


s 






le 




r\Q 
Uo 


zero 


a 




A 4 


eo 




04 


enter met 


r 




42 


e I 




1 o 


s eve n 






4 J 






11 










er 




UD 


weather 


J 




4D 


x.n 




UD 


ufiree tcjiick 


V- 
K. 




4d 


dh 




07 


■t"bist +'b*»n 


1 




47 


yu 




27 


use you 


OO 




50 


iu 




10 


unite 


ou 




51 


Ju 




11 


new you 


ng 




53 


oO 




31 


only no 


z 




55 


o1 




12 


hello 


sh 




56 


o2 




13 


notice 


ch 




57 


uO 


s 


14 


but must 


V 




60 


u1 




15 


uncle 


b 




61 


U2 




16 


stirrup 


n 




62 


u3 




34 


app^le ab_le 


m 




63 


ae 




21 


cat^sat 


iy 




66 


ea 




20 


antenna 


zh 




70 


w 




22 


won wish 


Ih 




72 


ee 




23 


three 


ay 




36 


r 




24 


radio radar 








t 




25 


two time 


-0 




35 


ey 




26 


sixtY eighty 


-1 




17 


iO 




30 


six mix 


-2 




01 


i1 




64 


inept inside 


-3 


s 


74 


i2 




65 


cryptic static 









£enny pound 
contact car 
connect 
name came 
namely 
seven six 
do diet 
four five 
3et 2^^^^^ 
hello how 
judge ed^e 
came lock 
hello light 
look book 
good shoud 
r ing angle 
zero hazy 
show ship 
chair chime 
seven even 
ball bed 
nine seven 
mile men 
lie 

azure pleasure 
station condition 
maY lay 

long space 



short delay 



SEE ALSO 



speak(l) , vt(lV) 
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20BOOT (VIII) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 
DIAGNOSTICS 



20boot — install new 11/20 system 
20boot [ X ] 

This shell command file copies the current ver- 
sion of the 11/20 program used to run the VT01 
display onto the /dev/vtO file. 

If no argument is given, the 11/20 program should 
be executing but idlej^ the 11/20 program is sent 
preceded by a "reboot command. If an argument 
is given, the 11/20 should have been restarted at 
its ROM location 777300. 



/dev/vtO; 
/sys/mdec/20 ,o 

vtO (IV) 



(1 1 /20 program) 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



acct — login accounting 

acct [ -w wtmp ] [ ^ ] [ ] people 

acct produces a printout giving connect time for 
each user who has logged in during the life of 
the current wtmp file. A total is also produced. 
~w is used to specify an alternate wtmp file. ^ 
prints individual totals; without this option, 
only totals are printed. ^ causes a printout 
for each midnight to midnight period. The people 
argument will limit the printout to only the 
specified login names. If no wtmp file is given, 
/u sr /adm/ wtmp is used. 

/u sr/adm/wtmp 

init(vil), login(l), wtmp(v). 

''cannot open 'wtmp'" if argument is unreadable. 



- 1 - 



BOOT PROCEDURES (VIIl) 



2/6/73 



BOOT PROCEDURES (VIIl) 



NAME bos, maki, vcboot, msys, et al, 

DESCRIPTION 

On the RF disk, the highest 1 6K words are reserved for 
stand-alone programs. These 1 6K words are allocated as 
follows : 

bos (1K) 
Warm UNIX (7K) 
Cold UNIX (8K) 

The program bos (Bootstrap Operating System) examines the 
console switches and executes one of several internal 
programs depending on the setting. The following set- 
tings are currently recognized? 

??? Will read Warm UNIX from the RF into core loca- 
tion and transfer to 600. 

1 Will read Cold UNIX from the RF into core loca- 

tion and transfer to 600. 

10 Will dump all of memory from core location onto 

DECtape drive 7 and then halt. 

20 Will read 256 words from RKO into core and 

transfer to zero. This is the procedure to boot 
DOS from an RK. 

40 This is the same as 10 above, but instead of 

halting, UNIX warm is loaded. 

Will load a standard UNIX binary paper tape into 

core location and transfer to 0. 

77500 Will load the standard DEC absolute and binary 
loaders and transfer to 77500. 

All manual methods of booting the system involve manipu^ 
lation of the console switches. In order for this to be 
possible, the panel roust be unlocked and the machine must 
be halted. Also, remember that at the time UNIX comes 
up, the console switches must contain 773030 for a 
single-user system; anything else gives a multi-user sys- 
tem. 

There are four temperatures of boots. They are: 

Hot boot: restart the system without refreshing its 
code, that is simply by transferring to its start. 
The only use for this procedure is if the system has 
been patched and one doesn't wish to redo the 
patches. The procedure is: 

600 in switches 
Load address 
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(773030 in switches for single-user system) 
start 

Warm^^ boot :^,re fresh system code from the RF disk, but 
the panic routine must be in core. Best for gen- 
eral use if it works, since outstanding l/o is 
cleaned up. Procedure: 

602 in switches 
load address 

(773030 in switches for single-user system) 

start (flushes any l/O, then executes bos ) 

Cool boot: RF disk is OK, but nothing in core. 
Procedure: 

UTIL DECtape on drive 
773030 in switches 
load address 

(602 in switches for multi-user system) 
start^^ 

type "boot" on console tty to load bos 

Cold boot: nothing in core, nothing on RF. Best to 
have an expert around for this one. Procedure: 

INIT DECtape on drive 
773030 in switches 
load address 
1 In switches 
start 

(machine halts, last chance to preserve RF!) 

773030 in switches 

continue 

(reads in basic files) 

UNIX is then up, but for various reasons, one should 
do a warm boot (single user) right away. At this 
point also, one might consider whether the INIT tape 
UNIX is the latest version. If there is reason for 
doubt, mount the /sys disk pack, change to directory 
/sys/sys, do "msys u unix", and reboot. Then get the 
/bin-/etc-/lib tape^which contains the rest of of the 
RF disk, and do an "mt x". Conceivably, "create 
errors" due to lack of some directories will occur; 
make the directories, then try again. Set the date 
correctly; the system starts off at time 0. 

At this point UNIX is in full operation and can be 
rebooted for a multi-user system. 

Here is what happens during a cold boot: the INIT tape 
contains a program called vcboot . The ROM program reads 
vcboot from the tape into core location and transfers 
to it. vcboot then reads 1 6K words from the DECtape 
(blocks 1-32) and copies the data to the highest 1 6K 
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words of the RF, Thus this initializes the read-only 
part of the RF. vcboot then reads in bos and executes 

"bos reads in Cold UNIX and executes that. Cold UNIX 
halts for a last chance before it completely initializes 
the RF file system. When continue is pressed, Cold UNIX 
initializes the RF. It then reads the DECtape for ini- 
tiali2sation files starting from block 33. ^^Normal opera- 
tion then commences with the execution of "/etc/init". 

The INIT tape is made by the program makl running under 
UNIX, maki writes vcboot on block of / dev / tap7 . It 
then copies the RF 1 6K words (using / dev / rfO ) onto blocks 
1 thru 32. It has internally a list of files to be 
copied from block 33 on. This list follows: 



/etc/init 

/bin/chmod 

/bin/date 

/bin/ log in 

/bin/Is 

/bin/mkdir 

/etc/mount 

/bin/sh 

/bin/tap 

/bin/mt 



Thus this is the set of programs available after a cold 
boot, init and sh are mandatory. For multi-user UNIX, 
getty and login are also necessary, mkdir is necessary 
due to a bug in tap , mt. tap and mount are useful to 
bring in new files. As soon as possible, date should be 
done. That leaves Is and chmod as frosting. 

The last link in this incestuous daisy chain is the pro- 
gram msys . 

msys char file 

will copy the file file onto the RF read only slot speci- 
fied by the character char . Char is taken from the fol- 
lowing set: 

b bos 

u Warm UNIX 
1 Cold UNIX 



FILES 



/dev/rf , /dev/tap? 



SEE ALSO 



init(VIl), tap(l), sh(l), mkdir(l) 



DIAGNOSTICS 



BUGS 



This section is very configuration dependent. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



BUGS 



check — file system consistency check 
check [ filesystem [ blockno^ ••• ] ] 

check will examine a file system, build a bit map 
of used blocks, and compare this bit map against 
the bit map maintained on the file system. If 
the file system is not specified, a check of all 
of the normally mounted file systems is per- 
formed. Output includes the number of files on 
the file system, the number of these that are 
'large', the number of indirect blocks, the 
number of used blocks, and the number of free 
blocks. 

check works by examining the i-nodes on the file 
system and is entirely independent of its direc- 
tory hierarchy. The file system may be, but need 
not be, mounted. 

/dev/rf?, /dev/rk?, /dev/rp? 

find(l), ds(l) 

Diagnostics are produced for blocks missing, 
duplicated, and bad block addresses. Diagnostics 
are also produced for block numbers passed as 
parameters. In each case, the block number, 
i-number, and block class (i = inode, x indirect, 
f free) is printed. 

The checking process is two pass in nature. If 
checking is done on an active file system, ex- 
traneous diagnostics may occur. 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 



chk — check + dcheck 
chk 

This command file does a check and a dcheck of 
all of the normally mounted file systems. 

/dev/[fkp]* 

check (VIII), dcheck (VIIl) 
see "see ALSo" 
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NAME 

SYNOPSIS 

DESCRIPTION 



clri — clear i-node 

clri i-number [ file system ] 

clri writes zeros on the 32 bytes occupied by the 
i-node numbered i -number > If the file system 
argument is given, the i-node resides on the 
given device, otherwise on a default file system. 
The file system argument must be a special file 
name referring to a device containing a file sys- 
tem. 

After c lri . „any blocks in the affected file will 
show up as "missing" in a check of the file sys- 
tem. 

Read and write permission is required on the 
specified file system device. The i-node becomes 
allocatable. 

The primary purpose of this routine is to remove 
a file which for some reason appears in no direc- 
tory. 



DIAGNOSTICS 



error 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



dcheck — directory consistency check 
dcheck [ ::i ] [ device ] 

dcheck builds an image of the directory hierarchy 
of the specified device by reading all its direc- 
tories (using physical l/o guided by the i-nodes 
on the device). A list entry is made for each 
file encountered. A second pass reads the i- 
nodes and for each file compares the number of 
links specified in its i~node with the number of 
entries actually seen. All discrepancies are 
noted. 

If no device is specified, a default device is 
assumed. 

The argument ^ causes a complete listing of the 
file names on the device in i-node order. 

/dev/rk? 

check(VIIl) 

inconsistent i-numbers, unnamed^f iles, unreach- 
able files, loops in directory "hierarchy". 

Unreachable files and loops are discovered only 
under the "-l" option. 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



dli — load DEC binary paper tapes 
dli output [input] 

dli will load a DEC binary paper tape into the 
output file. The binary format paper tape is 
read from the input file (/dev/ppt is default.) 

/dev/ppt 



"checksum" 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



Istat — get inode status 

Istat [ filesystem ] inuraber^ ... 

i Stat gives information about one or more i-nodes 
on the given file system or on /dev/rkO if no 
file system is given* 

The information is in exactly the same form as 
that for stat(l), except that mode letter "a" is 
used to indicate that the i-node is allocated, 
'*u*' that it is unallocated. 

/etc /u ids, /dev/rkO 

stat(l), ls(l) (-1 option) 



istat ignores any read error and pretends to give 
status even if the file system is not physically 
present. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



kill — terminate process with extreme prejudice 
/usr/adm/kill processnumber 

After 2S (q.v.) has given you the unique ID of a 
process, you can terminate it by this command, A 
core image is produced in the process's working 
directory. 

Only the super-user can exercise this privilege. 



ps (VIII) 
yes 

If the process has executed sys nice (II ) and 
there is another process which has not, but which 
loops, the first process cannot be done in prop- 
erly, since it has to be swapped in so as 
cooperate in its own murder. 

It would also be nice if ordinary people could 
kill their own processes. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



mount — mount file system 
/etc/mount special file 

mount announces to the system that a removable 
file system is present on the device correspond- 
ing to special file special (which must refer to 
a disk or possibly DECtape) . The file must exist 
already; it becomes the name of the root of the 
newly mounted file system. 



umount(VIIl) 

"?", if the special file is already in use, can< 
not be read, or if file does not exist* 

Should be usable only by the super-user. Mount- 
ing file systems full of garbage can crash the 
system. 
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NAME ps — process status 

SYNOPSIS /usr/adm/ps [ -xlt ] 

DESCRIPTION 

ps prints certain facts about active processes. The 
information is columnar and consists of: 

The (numerical) ID of the user associated with the 
process; 

The last character of the control typewriter of the 
process or "x** if there is no control typewriter; '*x** 
lines are suppressed unless the "x" option is given. 

The number of 512-tayte disk blocks holding the core 
image of the process; 

The process's unique ID (only with "l" option) 

The number of hours (mod 100) and minutes of system, 
disk, and user-process time accumulated by the^^process 
and all its terminated descendants (only with "t" 
option) 

An educated guess as to the command line which caused 
the process to be created. 

Some caveats j 

The guess as to the command name and arguments is ob- 
tained by examining the process's stack. The process is 
entitled to destroy this information. Also, only 
processes whose core images are on disk have visible 
names. The jds command in particular does not, nor does 
any other process which happens to be in core at the same 
time. 2s tries to overcome this limitation by spawning a 
subprocess designed to take up the other core slot, and 
is usually successful. Because ps examines a dynamically 
changing data structure, it can produce incorrect 
results, for example if a process's core image moves 
between the time £S gets its disk address and reads its 
stack. 

Besides its utility for simple spying, ^s is the only 
plausible way to find the process number of someone you 
are trying to kill (VIII). 

FILES /dev/rfO, /sys/sys/unix (to get magic numbers). 

SEE ALSO kill (VIII ) 

DIAGNOSTICS **Bad RF*', if a bad swap address turns up; various 

missing-file diagnostics. 

BUGS As described. 
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NAME salv — file system salvage 

SYNOPSIS /etc/salv filesystem [ -akf s ] 

DESCRIPTION 

salv will place a given file system in a consistent state 
with almost no loss of information. This is the first 
step in putting things together after a bad crash. Salv 
performs the following functions : 

A valid free list is constructed. 

The previous step is always performed; the following 
steps are performed only if the "a" option is given. If 
the file system's only defect is missing blocks, "a" 
should not be specified. 

All bad pointers in the file system are zeroed. 

All duplicate pointers to the same block are resolved 
by changing one of the pointers to point at a new 
block containing a copy of the data. 

Inodes (not directory entries) for special files are 
generated (mode 16). 

Files whose size is too large for the number of blocks 
they contain (after bad pointers are zeroed) have 
their size revised downward. 

The file system should be unmounted while it is being 
salvaged. In cases of extreme need the permanently 
mounted file system may be salvaged; in such a case the 
system must be rebooted before it has a chance to write 
out the old, bad super- block. 

The "k**, "f", and "s" options tell salv what magic 
numbers to use to generate the size of the free list and^ 
the i-node map. "k" is default (RK disk); "f" is RF; "s" 
is RK with swap space on it. If salv is to be used away 
from the mother system its code should be checked to ver- 
ify the numbers. 

After a salv, files may be safely created and removed 
without causing more trouble. If the "a" option had to 
be used, a dcheck (VIIl) should be done to find the de- 
gree of the damage to the hierarchy. 

SEE ALSO check(vill), dcheck(VIIl) 

BUGS In only one (known) way does salv destroy information: if 
some rando^n block appeals to be an indirect block for a 
file, all bad pointers (for example, ASCII text) in it 
will be zeroed. If the block also appears in another 
file, it may be scribbled on before it is copied. 
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NAME 

SYNOPSIS 

DESCRIPTION 



SU — become privileged user 
su 

su allows one to become the super-user, who has 
all sorts of marvelous (and correspondingly 
dangerous) powers. In order for su to do its 
magic, the user must supply a password. If the 
password is correct, su will execute the shell 
with the UID set to that of the super-user. To 
restore normal UID privileges, type an end-of- 
file to the super-user shell. 

To remind the super-user of his responsibilities, 
the shell substitutes for its usual prompt 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



sh(l) 

"sorry" if password is wrong 
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NAME 

SYNOPSIS 
DESCRIPTION 



FILES 
SEE ALSO 



swtmp — update accounting file 
swtmp 

This shell sequence concatenates /tmp/wtmp onto 
/usr/adm/wtmp and truncates /tmp/wtmp. It should 
be used before using acct(VIIl) and every so 
often in any case if accounting is to be main- 
tained. 

/tmp/wtmp, /usr/adm/wtmp 
acct(VIIl), wtmp(v) 
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NAME 

SYNOPSIS 

DESCRIPTION 



umount — dismount file system 
/etc/u mount special 

umount announces to the system that the removable 
file system previously mounted on special file 
special is to be removed. 

The user must take care not only that all l/O 
activity on the file system has ceased, but that 
no one has his current directory on it. 

Only the super-user may issue this command. 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



mount (VII I) 



This command is not, in fact, restricted to the 
super-user. 
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tm — provide time information 
tm 

tm is used to provide timing information. Output 
like the following is given: 



tim 


371 


!51 :09 


2 


!00.8 


ovh 


20 


:00:33 




17.0 


swp 


13 


:43:20 




4.6 


dsk 


27 


i14:35 




4.5 


idl 


533 


:08j03 


1 


!33.3 


usr 


24 


:53:50 




1 .2 


der 




0, 54 





• 



The first column of numbers gives totals in the 
named categories since the last time the system 
was cold-booted; the second column gives the 
changes since the last time tm was invoked^ The 
top left number is badly truncated and should be 
ignored, ovh is time spent executing in the 
system; swp is time waiting for swap l/O; dsk is 
time spent waiting for file system disk I/O: idl 
is idle time; usr is user execution time; der is 
RF disk error count (left number) and RK disk 
error count (right number). 

/dev/rfO (for absolute times); /tmp/ttmp for dif- 
ferential timing history. 

time(l), file system(v) 



